Skip to main content

Documentation Index

Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. Click 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. Click 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. Click 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
  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. Click Manage realms.
  4. Select repo.
  5. Select Users from the left hand-navigation.
  6. Click Create new user.
  7. Enter anaconda as the Username.
  8. Click Join Groups.
  9. Select admins.
  10. Click Join.
  11. Click Create.
  12. Click the Credentials tab.
  13. Click Set password.
  14. Enter and confirm a password for the anaconda admin user.
  15. Toggle Temporary OFF.
  16. Click Save.
  17. Return to your Anaconda Platform FQDN and sign in as the anaconda admin user.
  18. Submit your license.