# Docker

Deploy Quor with Docker Compose

import DeploymentNextSteps from "/snippets/deployment-next-steps.mdx"

<Tip>
  Check out the [Resourcing Guide](/deployment/getting_started/resourcing) before getting started with Docker.
</Tip>

<Note>
  This guide covers managing the compose files manually. For a guided install with managed upgrades,
  use the [Quor CLI](/deployment/local/onyx_cli)
  instead — it can also [adopt an existing manual setup](/deployment/local/onyx_cli#from-a-manual-docker-compose-setup)
  later.
</Note>

## Guide

**Note:** On Windows, the commands will be slightly different but all the steps are the same.

<Steps>
  <Step title="Install Requirements">
    - [Git](https://git-scm.com/downloads)
    - [Docker (with compose)](https://docs.docker.com/get-docker/)
  </Step>

  <Step title="Clone the Quor repo">
    ```bash
    git clone --depth 1 https://github.com/onyx-dot-app/onyx.git
    ```
  </Step>

  <Step title="Navigate to the compose files">
    ```bash
    cd onyx/deployment/docker_compose
    ```
  </Step>

  <Step title="Launch Quor">
    To pull images from Docker Hub and start Quor:

    ```bash
    docker compose up -d
    ```

    Alternatively, to build images from source:

    ```bash
    docker compose up -d --build --force-recreate
    ```

    <Warning>
      If you've previously launched Quor with the old `onyx-stack` service name,
      you'll need to add `-p onyx-stack` to your launch command.

      For example: `docker compose up -p onyx-stack -d`.
    </Warning>
  </Step>
</Steps>

After the containers come up,
the system needs to go through an initialization process after which you can access Quor at
[localhost:3000](localhost:3000).

## Enabling Quor Sandbox

Sandbox adds isolated sandbox containers and an egress proxy to the Docker Compose deployment.
Use the dedicated guide for both new and existing installations.

<Card title="Deploy Sandbox on Docker Compose" icon="docker" href="/deployment/local/craft_docker_compose">
  Install the Sandbox overlay, configure the sandbox API URL, plan host capacity, and verify the runtime.
</Card>

<DeploymentNextSteps />