Updating your domain

If you wish to change your domain—for instance, if you accepted the default domain temporarily until you knew the correct domain—then you need to make the change in Anaconda Server and Keycloak for the change to truly take effect.

This topic provides guidance on the following actions:

Updating the domain in Anaconda Server

To update the domain in Anaconda Server, you need to update the domain environment variable:

  1. Make a copy of the old .env file for reference and/or recovery purposes:

    cp .env .env.old
  2. Open the .env file, located in the same directory as the docker-compose.yml file.

  3. Update the <DOMAIN> variable to your new domain.


If you have existing clients (tools) configured to use the Anaconda Server instance using the old DNS name, you will need to update those clients as well.

Updating the domain in Keycloak

  1. From Anaconda Server, click on the My account button in the top right.

  2. In the dropdown, under Admin, select User Management.

  3. On the User Management screen, click the Manage Users button. You will be directed to the Keycloak login screen.

  4. Log in to Keycloak using the keycloak master realm admin account, and then go to the Clients page under Configure.

  5. On the Clients page, select repo-service. This is the default client ID.

  6. On the Repo-service page, scroll down to the Root URL and Valid Redirect URIs settings.

  7. Update the Root URL to your new domain:

  8. Update the Valid Redirect URIs to your new domain’s Keycloak redirect path:

  9. Click Save.

  10. If you have SSL, make sure to update your certificates in the Configuring SSL section to refer to your new domain.

  11. Run the following command:

    docker-compose up -d