Quickstart

​

Requirements

• git
• Docker with compose (docker version >= 1.13.0)
• System requirements found here

​

Setup

1. Clone the Danswer repo:

git clone https://github.com/danswer-ai/danswer.git

2. Navigate to danswer/deployment/docker_compose

cd danswer/deployment/docker_compose

3. (Optional) configure Danswer
4. Bring up your docker engine and run:
   • To pull images from DockerHub and run Danswer:
   Copy

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

   • Alternatively, to build the containers from source and start Danswer, run:
   Copy

   docker compose -f docker-compose.dev.yml -p danswer-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 (we download embedding models from HuggingFace to power the search). 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.

5. Danswer will now be running on http://localhost:3000.

​

Generative AI API Key

​

Indexing Documents

1. Navigate to the top right of Danswer’s home screen and select Admin Panel
2. In the Web Connector dashboard, pick any base URL to index.
   • This will index all pages under that base URL that is reachable from hyperlinks.
   • You can check the indexing status page to monitor the progress.

3. After the pages are indexed, you can now navigate back to the homepage and start asking questions and getting answers! 🥳

​

Shutting Down

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