Deploying Trains Server: Windows 10

For Windows, we recommend launching our pre-built Docker image on a Linux virtual machine (see Deploying Trains Server: Linux or macOS. However, you can launch Trains Server on Windows 10 using Docker Desktop for Windows (see the Docker System Requirements).

Deploying

Securing deployment

By default, Trains Server deploys as an open network. To restrict Trains Server access, follow the instructions in the Securing deployment section, on the "Configuring Trains Server" page.

To deploy your Trains Server on Windows 10, do the following:

  1. Install the Docker Desktop for Windows application by either:
  2. Increase the memory allocation in Docker Desktop to 4GB.
    1. In your Windows notification area (system tray), right click the Docker icon.
    2. Click Settings, Advanced, and then set the memory to at least 4096.
    3. Click Apply.

  3. Remove any previous installation of Trains Server.

    This clears all existing Trains SDK databases.

    rmdir c:\opt\trains /s

  4. Create local directories for data and logs. Open PowerShell and execute the following commands:

    cd c:
mkdir c:\opt\trains\data
mkdir c:\opt\trains\logs

  5. Save the Trains Server docker-compose YAML file.

    curl https://raw.githubusercontent.com/allegroai/trains-server/master/docker-compose-win10.yml -o c:\opt\trains\docker-compose-win10.yml

  6. Run docker-compose. In PowerShell, execute the following commands:

    docker-compose -f c:\opt\trains\docker-compose-win10.yml up

    Your server is now running on http://localhost:8080.

Port mapping

After deploying Trains Server, the services expose the following node ports:

  • Web server on port 8080.
  • API server on port 8008.
  • File server on port 8081.

Restarting

To restart your Trains Server Docker deployment, do the following:

  • To restart Trains Server, first stop and then restart the Docker containers by executing the following commands: 
    docker-compose -f c:\opt\trains\docker-compose-win10.yml down
docker-compose -f c:\opt\trains\docker-compose-win10.yml up -d

Upgrading

  1. Shut down the docker containers. Execute the following command: 
    docker-compose -f c:\opt\trains\docker-compose-win10.yml down

  2. We recommend backing up your data and, if your configuration folder is not empty, backing up your configuration.

    For example:

    For example, if your configuration is in c:\opt\trains, then backup c:\opt\trains\config and c:\opt\trains\data. Before restoring, remove the old artifacts in c:\opt\trains\config and c:\opt\trains\data, and then restore.

  3. Download the latest docker-compose.yml file. 
    curl https://raw.githubusercontent.com/allegroai/trains-server/master/docker-compose-win10.yml -o c:\opt\trains\docker-compose-win10.yml
  4. Spin up the docker containers. This automatically pulls the latest Trains Server build. 
    docker-compose -f c:\opt\trains\docker-compose-win10.yml pull
docker-compose -f c:\opt\trains\docker-compose-win10.yml up -d

If issues arise during your upgrade, see the FAQ page, How do I fix Docker upgrade errors?.

Next Step