danswer-docs/advanced_setup.mdx

---
title: Enterprise Setup
description: '[WIP] How to set up for an organization'
---

Below, we discuss the simplest possible way to setup Danswer within your enterprise. We know that every company does things 
differently, and we'd love to help you figure out the ideal setup for your enterprise! Feel free to reach out to us via
the links on our [Contact Us](https://docs.danswer.dev/contact_us) page.

## Getting a Machine

The first step is to get a machine hosted in your VPC to run Danswer on. 
- For AWS, this would be an EC2 instance. 
- For GCP, this would be a Google Compute Engine instance.  
- For Azure, this would be an Azure Virtual Machine instance.  
- For DigitalOcean, this would be a Droplet.
- ...

For resourcing, we recommend a machine with 8vCPU and 
16GB memory (although 4vCPU and 8GB memory can work in a pinch). With this basic setup, all components needed to
operate Danswer will run on this single machine.

## Setting Up the Domain

Modify your internal DNS to include entries which point to the private IPv4 address for the instance created above.  

## Starting Danswer

1. SSH into the machine setup in the `Getting a Machine` section.
2. If not already setup, install docker following the relevant guide here: https://docs.docker.com/engine/install/
3. Clone the [Danswer](https://github.com/danswer-ai/danswer) repo:
    `git clone https://github.com/danswer-ai/danswer.git`
4. Navigate to **danswer/deployment/docker_compose**
5. Bring up your docker engine and run:
    - Run `./init-letsencrypt.sh` to get a SSL certificate.
    - To pull images from DockerHub and run Danswer:
        - `docker compose -f docker-compose.prod.yml -p danswer-stack up -d --pull always`
    - Alternatively, to build the containers from source and start Danswer, run:
        - `docker compose -f docker-compose.prod.yml -p danswer-stack up -d --build --force-recreate`
    - This may take 15+ minutes depending on your internet speed.