Prerequisites

Overview

Before installing Authenta On-Prem, ensure that your system meets the hardware, software, and network prerequisites listed below.
These requirements are designed to guarantee stable performance, successful image pulls, and full offline operation after setup.

1. System Requirements

Authenta supports both CPU and GPU environments.
Hardware specifications vary based on the volume of media processed and desired inference speed.

✅ Minimum Recommended Hardware

💡 Tip: For production deployments or large-scale workloads, allocate dedicated GPU resources and SSD storage for improved throughput.

2. Software Requirements

Authenta relies on standard container and CLI tooling.
Ensure the following software is installed on your host system:

⚙️ Verify your installations:

docker --version
docker compose version
aws --version

3. GPU Environment (Optional)

If you plan to use GPU acceleration (ml-task-runner-gpu profile), you must install and configure the NVIDIA Container Toolkit and related drivers.

Required Components

Follow NVIDIA’s official setup and configuration guide:
👉 Install and Configure NVIDIA Container Toolkit →

⚠️ Important:
The toolkit installation guide includes a step to enable GPU support in Docker (by configuring the NVIDIA runtime in Docker’s settings). Make sure to complete this step — Authenta’s GPU containers require Docker to recognize the NVIDIA runtime. Skipping this configuration will cause GPU-enabled containers to fail at startup.

Once installation and configuration are complete, you can validate your GPU environment using NVIDIA’s own sample workload:
👉 Run NVIDIA Sample Workload →

Authenta does not require any additional verification beyond the steps in NVIDIA’s documentation.

4. Network & Access Requirements

Authenta operates fully offline after setup, but you'll need limited internet access initially to pull Docker images from our private AWS registry.

Required During Setup

⚠️ After installation, you may safely disable outbound internet and lock down ports for air-gapped operation.

5. File System & Storage Setup

Authenta requires a shared host directory that is mounted into containers for data exchange.

Ensure that:

• The directory exists before starting the containers
• Proper permissions are assigned (e.g., chmod -R 775 /opt/authenta/data)
• Sufficient disk space is available for temporary media storage

6. Access Permissions

To deploy Authenta, the executing user must have:

• Docker permissions (part of the docker group)
• Read/Write access to shared data and log directories
• Network access (for initial setup only)
• Authenta Registry Access: Authenta will provide your team with the AWS Account ID and temporary ECR credentials needed to pull images from Authenta’s private registry.

7. Optional Tools (for Debugging or Integration)

While not mandatory, the following tools are useful during setup or testing:

Summary