​
Requirements

  • Git
  • Docker with compose (docker version >= 1.13.0)

​
Setup

The most common source of issues is under-resourcing. Before beginning, check the system requirements here.

This is just one way to run Hymalaia. Hymalaia can also be run on Kubernetes, there are provided Kubernetes manifests and Helm charts in the deployment directory.

​
Step 1: Clone the Repository

Clone the Hymalaia repo:

git clone https://github.com/Hymalaia/Hymalaia.git

​
Step 2: Navigate to Docker Compose Directory

cd hymalaia/deployment/docker_compose

​
Step 3: Configure and Deploy

  1. (Optional) configure Hymalaia

  2. Bring up your docker engine and run:

To pull images from DockerHub and run Hymalaia:

docker compose -f docker-compose.dev.yml -p hymalaia-stack up -d --pull always --force-recreate

Alternatively, to build the containers from source and start Hymalaia, run:

docker compose -f docker-compose.dev.yml -p hymalaia-stack up -d --build --force-recreate
  • This may take 15+ minutes depending on your internet speed.
  • Additionally, once the images have been pulled / built, the initial startup of the api_server may take some time. If you see “This site can’t be reached” in your browser despite all containers being up and running, check the api_server logs and make sure you see “Application startup complete”.
  • If you see “Killed” in the logs, you may need to increase the amount of memory given to Docker. For recommendations, check the system requirements here.
  • These commands are also used to redeploy if any .env variables are updated

Once completed, Hymalaia will be running on http://localhost:3000.

​
Generative AI API Key

On the initial visit, Hymalaia will prompt for a GenAI API key.

For example, you can get an OpenAI API key at: https://platform.openai.com/account/api-keys

Hymalaia relies on Generate AI models to provide parts of its functionality. You can choose any LLM provider from the admin panel or even self-host a local LLM for a truely airgapped deployment.

​
Shutting Down

To stop Hymalaia, run:

docker compose -f docker-compose.dev.yml -p hymalaia-stack down

Add -v at the end to additionally delete the volumes (containing users, indexed documents, etc.)