Configuring ClearML for Your ClearML Server¶
This documentation page applies to deploying your own open source ClearML Server. It does not apply to ClearML Hosted Service users.
Configure it for your ClearML Server. The ClearML configuration file you initialize will contain the host URLs of your ClearML Server and your ClearML credentials allowing your code to integrate with the server. Later, you can tailor ClearML to your requirements by setting configuration options.
To configure ClearML for your ClearML Server:
In a terminal session, run the ClearML setup wizard (if you did not already install
clearml, install it and then run setup wizard).
Learn about creating multiple ClearML configuration files
You can create additional ClearML configuration files, for example to use inside Docker containers when executing a Task.
clearml-init --file MyOtherClearML.conf
and then specify it using the
CLEARML_CONFIG_FILEenvironment variable inside the container:
CLEARML_CONFIG_FILE = MyOtherClearML.conf
If the setup wizard’s response indicates you already have a configuration file, follow the instructions in here. The wizard does not edit or overwrite existing configuration files.
The setup wizard prompts for your ClearML credentials.
ClearML SDK setup process Please create new clearml credentials through the profile page in your clearml web app (e.g. http://localhost:8080/profile) Or with the free hosted service at https://app.community.clear.ml/profile In the profile page, press "Create new credentials", then press "Copy to clipboard". Paste copied configuration here:
Get your ClearML credentials. Open the ClearML Web UI in your browser. On the PROFILE page, click Create new credentials > Copy to clipboard.
At the command prompt
Paste copied configuration here:, copy and paste the ClearML credentials.
The setup wizard confirms the credentials.
Detected credentials key="********************" secret="*******"
Enter the ClearML Server web server URL, or press Enter to accept the default which is detected from your credentials.
WEB Host configured to: [https://app.<your-domain>]
Enter the ClearML Server API server URL, or press Enter to accept the default value which is based on your previous response:
API Host configured to: [https://api.<your-domain>]
Enter the ClearML Server file server URL, or press Enter to accept the default value which is based on your previous response:
File Store Host configured to: [files.<your-domain>]
The wizard responds with your configuration and directs you to your ClearML Server.
CLEARML Hosts configuration: Web App: https://app.<your-domain> API: https://api.<your-domain> File Store: https://files.<your-domain> Verifying credentials ... Credentials verified! New configuration stored in /home/<username>/clearml.conf CLEARML setup completed successfully.
The configuration file’s location depends upon your operating system:
Add ClearML to a configuration file¶
The setup wizard may indicate that you already have a configuration file. For example, if you previously configured ClearML Agent, you created a configuration file. The wizard does not edit or overwrite existing configuration files.
The host URLs for your ClearML Server are required:
ClearML Server web server
ClearML Server API server
ClearML Server file server
These may be localhost, your domain, or a sub-domain of your domain.
To add ClearML settings to an existing ClearML configuration file:
Open your ClearML configuration file for editing. Depending upon your operating system, it is:
sdk.developmentsection, add the logging of environment variables option (see
log_os_environmentsin an example configuration file).
# Log specific environment variables. OS environments are enlisted in the "Environment" section # of the Hyper-Parameters. # multiple selected variables are supported including the suffix '*'. # For example: "AWS_*" will log any OS environment variable starting with 'AWS_'. # This value can be overwritten with os environment variable CLEARML_LOG_ENVIRONMENT="[AWS_*, CUDA_VERSION]" # Example: log_os_environments: ["AWS_*", "CUDA_VERSION"] log_os_environments: 
Save your ClearML configuration file. ClearML is now configured for your ClearML Server.