Docker

Deploy Quadratic with Docker to almost any hardware.

Docker deployments with Quadratic are a few easy steps away. Instructions vary depending on operating system.

MacOS and Linux

Basic requirements:

• License Key (available at https://selfhost.quadratichq.com/)

• The following open ports: 80, 443, 3001, 3002, 3003, 4433, 4455, and 8000

• Docker

curl -sSf https://raw.githubusercontent.com/quadratichq/quadratic-selfhost/main/init-local.sh -o init.sh && bash -i init.sh

This will start the process of downloading and running containers, also prompting for the license key that you can acquire for free at https://selfhost.quadratichq.com/. Quadratic self-hosting is free for up to three users on a single deployment.

Need help? Contact us.

Windows

Running on Windows requires using WSL 2 with Docker integration enabled.

1. WSL 2 set up, here are installation instructions: https://learn.microsoft.com/en-us/windows/wsl/install

2. Add Docker to WSL: https://docs.docker.com/desktop/features/wsl/

3. Retrieve license key:

4. Run command to download and run containers, this step will also prompt for license

curl -sSf https://raw.githubusercontent.com/quadratichq/quadratic-selfhost/main/init-local.sh -o init.sh && bash -i init.sh

Need help? Contact us.

Enabling AI

If you want to enable AI in self-hosting you'll need to add your own AI provider API keys to the .env.

You can find the .env by navigating to the quadratic-selfhost folder and opening the .env file within. In the AI section you'll find a place for OpenAI and Anthropic keys.

Once you've edited your .env you can stop and start the Docker containers from the quadratic-selfhost folder using the commands ./stop.sh and ./start.sh

Common errors

Toomanyrequests: this error will happen if you have not logged in to Docker when trying to download and run containers. Use Docker login in your terminal to fix.

Error getting credentials: https://forums.docker.com/t/error-failed-to-solve-error-getting-credentials-err-exit-status-1-out/136124

Docker + WSL virtualization errors: ensure virtualization is enabled in your BIOS: https://support.microsoft.com/en-us/windows/enable-virtualization-on-windows-c5578302-6e43-4b4b-a449-8ced115f58e1

Contact us

You can contact us if you need any more help setting up a deployment of Quadratic using Docker.