Preparing the air-gapped environment
Hardware requirements
- 4 CPUs
- 16GB RAM
- 1.5TB storage space
- Conda_air gap zip file is ~1.1TB
- CVE zip file is ~100MB
/var/lib
and the remaining 1.5TB for /opt/anaconda
.
Software requirements
The installer is a self-extracting binary that contains all the necessary components to run Anaconda Server services. The basic requirements prior to installation are:- Any Linux variant capable of supporting Docker
- Use a fully qualified domain name (FQDN) or Hostname
- DNS record and TLS/SSL certs
- Make sure that SELinux is not in enforcing mode, either by disabling it or putting it in
permissive
mode in the/etc/selinux/config
file. If it is in enforcing mode, you will need to reboot your instance after updating. After rebooting, run the following command to verify that SELinux is not being enforced:
- Docker Engine 23.x+ (Supports Compose format 3.8)
- Docker Compose 2.1+ (Supports Compose format 3.8)
Installing packages and CVE files
Artifact download authorization Anaconda supplies air-gapped customers with our repository in the form of tarball files. In order to gain access to the tarball files that contain the conda packages and CVEs, you must provide Anaconda with the IP address of the machine you are using to download them. Speak with your Anaconda implementation team member to get help allowlisting your IP address.This must be completed prior to scheduling your implementation with Anaconda. The download will take several hours.
.env
file to point to the location of the CVEs.
Downloading the Anaconda Server Packages may take several hours.
Downloading the
conda_msys2.zip
and conda_r.zip
files is optional.Do not unzip the air gap or cve files.
DNS and TLS/SSL certificate requirements
Anaconda Server can use certificates to provide transport layer security for the cluster. It is required to have your TLS/SSL certs prior to installation; otherwise, self-signed certificates can be generated during the initial installation. You may purchase certificates commercially, use Let’s Encrypt, or generate them using your organization’s internal public key infrastructure (PKI) system. When using an internal PKI-signed setup, the CA certificate is stored on the file system. You will need to make sure the root certificate of your certificate authority is trusted by the server running the application and the workstations used by users of the application. DNS requirements Web browsers use domain names and web origins to separate sites, so they cannot tamper with each other. If you want to use DNS, you must have it ready prior to installation. This DNS name is what users will use to access the application. You must provide the SSL cert for the hostname your Anaconda Server instance is running on.Security requirements
External Ports These are ports that allow access outside of the server. It is important to protect all services running on the node from outside access. The exceptions are as shown below. These ports need to be open to allow access to Anaconda Server via browser and (optionally) via SSH::443
nginx - only if you are using HTTPS:22
ssh - optional; only if you need SSH
docker ps
and reference the PORTS column, as shown in the following example:

:5000
repo - Anaconda Server API:5002
repo-proxy - Anaconda Server file serving API proxy:5000
repo-dispatcher - Anaconda Server event dispatcher/handler (exposed only for prometheus metrics):5000
repo-worker - Anaconda Server scheduled jobs worker (exposed only for prometheus metrics):8080
keycloak - Keycloak’s /auth/* endpoints are proxied in Nginx:5432
postgres - Postgresql database used by Anaconda Server and Keycloak:6379
redis - Redis instance used by Anaconda Server services:9090
prometheus - Prometheus is proxied in Nginx at /Prometheus
Enable IP address forwarding
Forwarding IP addresses allows containers to communicate with one another on your host. You’ll need to configure these settings to allow non-root users to perform installations of Anaconda Server.System validation checks
Once your environment is prepared, run the following commands to verify it is ready for installation of Anaconda Server.System validation
System validation
To verify what type of processor your system is running and the number of CPUs present, run the command:To verify the amount of system memory is sufficient, run the command:To verify there is a sufficient amount of disk space for the installation, run the command:To verify the kernel release version and processor type, run the command:To verify your operating system release version, run the command:To verify your version of Docker, run the command:To verify your version of
docker-compose
, run the command:After ensuring all requirements have been met, proceed to Air gap installation to install Anaconda Server in your air-gapped environment.