1. Go to Digital Ocean and create an account.
  2. Create a new Droplet.
  3. Choose the Docker image from the Marketplace.


  1. Choose the Standard Droplet plan.

We recommended the $48/month plan for the best performance with 4 vCPUs, 8GB RAM, and 160GB SSD.

  1. Wait for the Droplet to be created.

  2. SSH into your Droplet.

ssh root@your-droplet-ip
  1. Clone the Quivr repository.
git clone https://github.com/QuivrHQ/quivr.git && cd quivr
  1. Copy the .env.example file.
cp .env.example .env
  1. Update the .env file.
vim .env
  • Update the OPENAI_API_KEY
  • Update the NEXT_PUBLIC_BACKEND_URL with your Droplet IP -> http://your-droplet-ip:5050
  • UPDATE the NEXT_PUBLIC_SUPABASE_URL with your Droplet IP -> http://your-droplet-ip:54321
  • Update the NEXT_PUBLIC_FRONTEND_URL with your Droplet IP -> http://your-droplet-ip:3000
  1. Install Supabase
apt install npm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
cd backend
npx supabase start
cd ..
  1. Allow the firewall
ufw allow 54321
  1. Launch the project
docker compose pull
docker compose up

It needs at least 5 minutes to build the frontend and pulling the Docker images.

  1. Access the Quivr app