​

Athina Self Hosting Guide

The example below is for Azure, but similar steps can be followed for other cloud providers.

​

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):
  Copy

  Ask AI

  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

or

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

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

​

Updates

You can use the athina.sh for starting, stopping, updating and restarting the services in docker-deploy.

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

You can edit few configurations in the database to customize the platform. Particularly, you can set the domain in the org table. If you populate the domain column all subsequent users signing up using the same domain will be automatically be added to the same org, instead of creating a new org.

-- 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';