Linux or macOS
Important: Upgrading from v0.14 or older
For Linux only, if upgrading from Trains Server v0.14 or older, configure the ClearML Agent Services.
- If
CLEARML_HOST_IP
is not provided, then ClearML Agent Services uses the external public address of the ClearML Server. - If
CLEARML_AGENT_GIT_USER
/CLEARML_AGENT_GIT_PASS
are not provided, then ClearML Agent Services can't access any private repositories for running service tasks.
note
For backwards compatibility, the environment variables TRAINS_HOST_IP
, TRAINS_AGENT_GIT_USER
, and 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).
If upgrading from Trains Server version 0.15 or older, a data migration is required before continuing this upgrade. See instructions here.
If upgrading from ClearML Server version older than 1.2, you need to migrate your data before upgrading your server. See instructions here.
Backing up data is recommended and, if the configuration folder is not empty, backing up the configuration.
If upgrading from Trains Server to ClearML Server, rename
/opt/trains
and its subdirectories to/opt/clearml
.Download the latest
docker-compose.yml
file.Startup ClearML Server. This automatically pulls the latest ClearML Server build.
If issues arise during your upgrade, see the FAQ page, How do I fix Docker upgrade errors?.