This documentation page applies to deploying your own open source ClearML Server. It does not apply to ClearML Hosted Service users.
Important: Upgrading from v0.14 or older
For Linux only, if upgrading from Trains Server v0.14 or older, configure the ClearML Agent Services.
CLEARML_HOST_IPis not provided, then ClearML Agent Services will use the external public address of the ClearML Server.
CLEARML_AGENT_GIT_PASSare not provided, then ClearML Agent Services will not be able to access any private repositories for running service tasks.
For backwards compatibility, the environment variables
TRAINS_AGENT_GIT_PASS are supported.
To upgrade ClearML Server Docker deployment:
Shutdown ClearML Server. Execute the following command (which assumes the configuration file is in the environment path).docker-compose -f docker-compose.yml down
If upgrading from Trains Server version 0.15 or older to ClearML Server, a data migration is required before upgrading. First follow these data migration instructions, and then continue this upgrade.
We recommend backing up data and, if the configuration folder is not empty, backing up the configuration.
If upgrading from Trains Server to ClearML Server, rename
/opt/trainsand its subdirectories to
/opt/clearml.sudo mv /opt/trains /opt/clearml
Download the latest
docker-compose.ymlfile.curl https://raw.githubusercontent.com/allegroai/clearml-server/master/docker/docker-compose.yml -o /opt/clearml/docker-compose.yml
Startup ClearML Server. This automatically pulls the latest ClearML Server build.docker-compose -f /opt/clearml/docker-compose.yml pulldocker-compose -f /opt/clearml/docker-compose.yml up -d
If issues arise during your upgrade, see the FAQ page, How do I fix Docker upgrade errors?.