Deploying Trains Server: Windows 10

Trains is now ClearML

This documentation applies to the legacy Trains versions. For the latest documentation, see ClearML.

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).


Securing deployment

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

To deploy your Trains Server on Windows 10:

  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 -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


To restart your Trains Server Docker deployment:

  • 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


  1. Shut down the docker containers. Execute the following command:

    docker-compose -f c:\opt\trains\docker-compose-win10.yml down
  2. If you are upgrading Trains Server version 0.15 or older, a data migration is required before you upgrade. First follow these data migration instructions, and then continue this upgrade.

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

    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.

  4. Download the latest docker-compose.yml file.

    curl -o c:\opt\trains\docker-compose-win10.yml
  5. Startup Trains Server. 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