​

Athina Self Hosting Guide

​

Prerequisites

• Create a VM with at least 64GB of free disk space, 16GB of RAM, and 4 CPUs. Assign a public DNS to the instance as well.
• SSH into the instance and set up the following:
  • Install git
  • Install Docker
  • Install Docker Compose
  • Install nvm and Node.js
  • Install Python 3.9 and pip
  • Install AWS CLI (For ECR)
• Obtain Athina GitHub access credentials.
• Obtain Athina ECR access credentials (AWS CLI is required).

​

Core Services Setup

• Clone the athina-deploy repository (ensure all Athina project folders are at the same directory level):
  git clone https://github.com/athina-ai/athina-deploy
  
• Copy .example.env to .env.
• Populate the respective values. Some default values and keys are provided. You can change them if needed. The DB Name can remain as it is.
• Create a Google OAuth client for Google login (Google Sign-In Documentation). Ensure you set the correct redirect URI and authorized domain (:9000/auth/google/redirect).

​

Transactional Emails (Optional)

• We use Loops for transactional emails like user invitations, OTP sending, and downloading exported data.
• Create a free account and obtain the API key from the Loops dashboard.
• Create three transactional email templates:
  • User invitation email:
    • Data variables: inviterName and invitedEmail
  • OTP email:
    • Data variable: otp
  • Data export email:
    • Data variable: s3_link

​

Services Creation

• Log in to ECR using credentials:

aws ecr get-login-password --region eu-central-1 | docker login --username AWS --password-stdin 867387325299.dkr.ecr.eu-central-1.amazonaws.com

• Pull the required images:

docker-compose --profile core --profile worker pull

• Ensure that the .env file in athina-deploy is updated with the right values.
• For worker services, ensure the following environment variables are set correctly:

AWS_LAMBDA_API_KEY=<SOME_KEY>
LAMBDA_TRIGGER_WORKER_FUNCTION_URL=http://IP:8000/trigger-job-workers # Change the IP to the IP of the instance.
WORKER_API_KEY=<SOME_KEY> # same as `AWS_LAMBDA_API_KEY`.

• Run the following command to start services:

docker-compose --profile core --profile worker up -d

• Wait for all services to start.

​

Dashboard

• There are two ways of running the dashboard. One is using a prebuilt image with docker-compose and docker, the other is using node and npm directly.

​

Using docker compose and docker

• Ensure the right env variables are set

# API URL
NEXT_PUBLIC_API_URL=
# Frontend URL
NEXT_PUBLIC_ATHINA_BASE_URL=
NEXT_PUBLIC_DEPLOYMENT_TYPE=self-hosted
NEXT_PUBLIC_AUTH_MECHANISMS=GOOGLE_OAUTH,EMAIL_PASSWORD,EMAIL_OTP

• Build the dashboard image:

docker-compose --profile dashboard run dashboard_builder

• If you are running into memory issues, you can build the dashboard image with increased memory limit:

docker-compose --profile dashboard run --env NODE_OPTIONS="--max-old-space-size=4096" dashboard_builder

• Run the dashboard:

docker-compose --profile dashboard up dashboard -d

​

Using node and npm directly

• Clone the athina-dashboard repository and switch to the main branch:

git clone https://github.com/athina-ai/athina-dashboard
git checkout main

• Ensure you are on the main branch of the athina-dashboard repository.
• Copy the following to .env:

# API URL
NEXT_PUBLIC_API_URL=
# Frontend URL
NEXT_PUBLIC_ATHINA_BASE_URL=
NEXT_PUBLIC_DEPLOYMENT_TYPE=self-hosted
NEXT_PUBLIC_AUTH_MECHANISMS=GOOGLE_OAUTH,EMAIL_PASSWORD,EMAIL_OTP

• Set them to the correct values.
• You can build either by installing yarn or by using a pre-built nodejs docker image (Recommended):

yarn install 
npm run build
bash script.sh start

docker run --rm -v $(pwd):/app -w /app node:20 sh -c "yarn install && yarn build"

• Navigate to http://<IP/DOMAIN>:3000/login.

​

Updates

bash athina.sh start # Start the services
bash athina.sh stop # Stop the services
bash athina.sh pull # Pull the latest images
bash athina.sh update # Update the services
bash athina.sh restart # Restart the services

​

Post Installation

-- Replace 'your_org_id' with the actual org_id
SELECT id FROM org;

-- Query for setting your domain so that further users signing up will be added to your org
UPDATE org SET domain = 'your_domain' WHERE id = 'your_org_id';

-- Set max_evals_per_month to 1000.
UPDATE org SET max_evals_per_month = 1000 WHERE id = 'your_org_id';

-- Paywall org config updated with allowed team members
UPDATE paywall_org_config SET allowed_team_members = 25 WHERE org_id = 'your_org_id';