Server Setup

From #openttdcoop wiki

Revision as of 11:12, 8 November 2013 by Taede (Talk | contribs) (Created page with "== Server Administration (Soap) == === Servers / Directories === {| class="wikitable" |+ |- ! Name !! Address !! Port !! Admin Port !! IRC chann...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Server Administration (Soap)

Servers / Directories
Name Address Port Admin Port IRC channel Directory
Public Server 3983 3982 #openttdcoop ~/svn-publicserver/
Name Address Port Admin Port IRC channel Directory
Welcome Server 3999 3998 #openttdcoop.stable ~/svn-stable/

Both game port and admin port numbers should be unique for each server. Exceptions are temporary servers which will never run simultaneously. An example of this are the patch test servers (YACD, h2h, etc) which are run in

Directory Structure

Each server should adhere to the following directory structure:

Top directory

Contains the SVN checkout, existing files should not be altered manually. The subdirectories bin/, bundle/, media/, os/, projects/ and src/ are also part of the SVN checkout and should not be altered manually.


Contains patches to applied to the source. Unless the server is meant to test patches for multi-player compatibility, patches in here should be multi-player safe. No changes in savegame allowed either, we want people to be able to download and play these games in vanilla OpenTTD


In here is the actual running server. important files include:

  • content_download: This should sym-link to shared content_download per user, generally ~/content_download/
  • ofs-*: Filehandling scripts used by Soap. These can be executed manually for troubleshooting.
  • openttd: The game, need I say more? Preferably use to start it rather than simply running ./openttd. Ofs-start will ensure the right cfg file and latest autosave gets loaded
  • save/autosave/: Ofs-start will load the most recent savegame from here, including autosavesoap.sav (generated when Soap shuts down the server for restart/update etc.)
  • save/uploads/: Set ofs-getsave to download savegames into this directory.


This directory willbe accessible through http as http://<serveraddress>/<port>/. Ofs-scripts will place some files here needed by tools such as autostart.

  • grfversion: currently used #openttdcoop NewGRF package version (must be updated/created manually)
  • rev (NOT YET IMPLEMENTED): contains the currently installed SVN revision, kept up-to-date by ofs-svnupdate
  • $OS.url (NOT YET IMPLEMENTED): links to the relevant binary downloads, kept up-to-date by ofs-svnupdate

Required extras

Openttd File Scripts (OFS,

These file scripts should be installed in the server/ directory, where the server binary is located. Configure these for the above directory structure by editing the appropriate scripts. Each one contains a few configuration lines at the top of the file.

Powered by MediaWiki