Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Installation Setup

This guide will walk you through the process of installing Authenta On-Prem in your environment.

Prerequisites Check

Before proceeding, ensure you have met all prerequisites:

  • Hardware requirements
  • Software dependencies
  • Network access
  • Storage setup
  • Authenta Registry Credentials

Installation Steps

1. Prepare Environment

# Create required directories
sudo mkdir -p /opt/authenta/data
sudo chmod -R 775 /opt/authenta/data

2. Configure AWS Credentials

# Configure AWS CLI for ECR access
aws configure set aws_access_key_id <AWS_ACCESS_KEY>
aws configure set aws_secret_access_key <AWS_SECRET_ACCESS_KEY>
aws configure set default.region us-east-1

Tip: Replace <AWS_ACCESS_KEY> and <AWS_SECRET_ACCESS_KEY> with the value provided by Authenta Support.

Note: Authenta provides its AWS Account ID and read-only ECR credentials privately to verified enterprise clients during onboarding. These credentials are required to pull container images from Authenta’s private registry. For credential delivery or renewal, please contact Authenta Support.

✅ Verify AWS Login

You can verify that your AWS CLI is configured correctly and authenticated by running:

aws sts get-caller-identity

Expected output:

{
  "UserId": "AIDAEXAMPLE123",
  "Account": "111122223333",
  "Arn": "arn:aws:iam::111122223333:user/authenta-client"
}

If this command returns valid account information, your AWS credentials are correctly set up.

3. Download Authenta Deployment Artifacts

Authenta provides a public GitHub repository containing all deployment artifacts and the required Docker Compose configuration.

Clone the repository:

git clone https://github.com/praveen-benedict-authenta/authenta-docs.git

Move into the artifacts directory:

cd authenta-docs/artifacts

This folder contains:

  • docker-compose.yml — defines the required Authenta services (RabbitMQ, ML Task Runner, etc.)
  • demo-webapp/ — a sample application to test model inference (optional)
  • Other deployment-related files and configurations.

4. Authenticate and Deploy Containers

Authenticate to Authenta’s private ECR and start all services using Docker Compose.

# Authenticate to Authenta’s ECR
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin <AUTHENTA_ACCOUNT_ID>.dkr.ecr.us-east-1.amazonaws.com
 
# For GPU environment:
docker compose --profile gpu up -d
 
# For CPU-only environment:
docker compose --profile cpu up -d

Important: Run the docker compose up command inside the artifacts directory where the official docker-compose.yml file is located. Docker will automatically detect and use this compose file to launch the required services.

Once the containers are up, Authenta’s services (RabbitMQ and ML Task Runner) will start automatically and operate within your network.

5. Verify Deployment

Check the running containers:

docker compose ps

You should see containers for:

  • rabbitmq
  • ml-task-runner-cpu or ml-task-runner-gpu (depending on configuration)

Once these are active, Authenta On-Prem is deployed and ready to process inference jobs.

✅ At this stage, your service is live. You can begin publishing tasks to RabbitMQ — Authenta will automatically process them using the configured models.

6. (Optional) Test with the Demo Web Application

Authenta includes a demo web application that is bundled inside the Docker deployment. This application can be used to verify that:

  • RabbitMQ messaging is functioning

  • The ML task runner is processing jobs correctly

  • Results are returned through the pipeline

Once the containers are running, the demo web interface will be available at: 👉 http://localhost:3000

You can use the web interface to submit sample media and verify that RabbitMQ and the ML task runner are communicating properly.

Post-Installation

  1. Access the RabbitMQ management dashboard at: 👉 http://localhost:15672

    • Username: admin
    • Password: (refer to your configuration file)

  2. Once verified, you can disable internet access for full offline operation. Authenta continues to function without any external connectivity.

Next Steps

Troubleshooting

If you encounter any issues:

  1. Check the troubleshooting guide
  2. Review container logs for detailed error messages
  3. Contact support for assistance