Skip to main content
Anaconda Platform 7.0.0 is available through a limited early access program. Contact your Anaconda Technical Account Manager (TAM) if you’re interested in adopting the latest version.

​
Prerequisites

  • System requirements are met and the environment is prepared.
  • Access to the Replicated download portal for your organization (invite provided by Anaconda).
  • SSH access, root/sudo access, and permissions to upload/download files to the host where you’ll install Anaconda Platform.
  • A Fully Qualified Domain Name (FQDN) for the host where you’ll install Anaconda Platform.
  • SSL/TLS plan:
    • Preferred: Organizational certificates ready to upload during setup.
    • Temporary: If organizational certs are not yet available, proceed with self-signed certificates during setup and replace them later from the Admin Console.

​
Installation overview

Anaconda Platform (Self-Hosted) is installed and managed using Replicated, a commercial software distribution platform. However, when interacting with Replicated, all web traffic is routed through anaconda.com domains.
Use the link supplied by Anaconda to access your Replicated download portal.

​
Installing Anaconda Platform

1

Download and run the installer

  1. Open a terminal and SSH into your prepared host environment.
  2. Open a browser and access the Replicated download portal.
  3. Follow the instructions provided in the portal to download, extract, and install Anaconda Platform in your terminal.
  4. Establish a password for your Admin Console when prompted.
  5. The installer initializes and runs preflight checks on your system.
    If any checks fail, address the failure and try the installation command again.
  6. Allow time for the installer to complete. A successful installation looks like this:
    Terminal showing successful platform installation
2

Configure the Admin Console

  1. Open a browser and navigate to the displayed Admin Console URL.
  2. Select Start and follow the instructions provided to proceed with setup.
  3. Enter your hostname’s FQDN.
  4. Choose to upload your organization’s SSL/TLS certificate and private key or use the self-signed certificate to get started.
    These SSL/TLS and Hostname configurations apply to the Admin Console only.
  5. Select Continue.
3

Configure the cluster

  1. Use the password you established during installation to access the Admin Console.
  2. Scroll down and select Continue to set up a single node cluster.
4

Configure the platform

  1. Enter your hostname’s FQDN.
  2. Supply your SSL/TLS certificates, or clear the Upload a TLS Certificate checkbox and select the Use Let’s Encrypt Staging Environment checkbox to use self-signed certificates.
    These SSL/TLS and Hostname configurations apply to the platform itself, not the Admin Console.
    Using the Let’s Encrypt staging environment also requires you to enter a valid email address for expiration reminders.
  3. Select the checkboxes for the features you want to include in your platform installation.
  4. Select Continue.
  5. Wait for all services to report as Ready in the console dashboard.
    Anaconda Platform dashboard - Ready deployment
  6. When deployment is complete, open a new browser tab and navigate to your FQDN to access Anaconda Platform.

​
Post install setup

Once installation is complete and you can reach your Anaconda Platform URL, you must create a user to log in with. However, you must first extract and decrypt your administrator login information for Keycloak.
1

Extract and decode your Keycloak password

  1. Return to your terminal and enter the platform debug shell by running: 
    sudo ./ai-platform shell
  2. List all available namespaces in the cluster: 
    kubectl get ns
  3. Find the KeyCloak secret: 
    kubectl get secrets -n ai-platform
kubectl get secrets -n ai-platform keycloak-secret-v1 -o yaml
  4. Copy the value for adminPassword.
  5. Decode the Keycloak admin password: 
    echo -n "<ENCODED_STRING>” | base64 -d
    Replace <ENCODED_STRING> with the adminPassword value you copied.
  6. Copy the return from the command.
    Decoded Keycloak admin password
2

Create your first admin user

  1. Return to your browser and navigate to the Keycloak console at https://<FQDN>/auth/admin in your browser, where <FQDN> is your Anaconda Platform fully qualified domain name.
  2. Sign in as admin using the decoded password.
  3. Select Manage realms.
  4. Select repo.
  5. Select Users from the left hand-navigation.
  6. Select Create new user.
  7. Enter anaconda as the Username.
  8. Select Join Groups.
  9. Select admins.
  10. Select Join.
  11. Select Create.
  12. Select the Credentials tab.
  13. Select Set password.
  14. Enter and confirm a password for the anaconda admin user.
  15. Toggle Temporary OFF.
  16. Select Save.
  17. Return to your Anaconda Platform FQDN and sign in as the anaconda admin user.
  18. Submit your license.