# Run with Docker

How to run the Super Productivity web app in Docker, and how to use the WebDAV integration.

## Run the Web App only

```bash
docker run -d -p 80:80 super-productivity/super-productivity:latest
```

Open [http://127.0.0.1](http://127.0.0.1). The image matches the host platform by default. Use `--platform` for another architecture (e.g. `linux/amd64`, `linux/arm64`, `linux/arm/v7`).

Data is stored in the browser; the container does not provide persistent storage.

## Run with WebDAV

To serve the app and a WebDAV backend from the same host:

1. Copy the repo files to a folder (e.g. `sp/`):

   ```bash
   git clone https://github.com/super-productivity/super-productivity.git
   mkdir -p sp
   cp super-productivity/docker-compose.yaml sp/
   cp super-productivity/webdav.yaml sp/
   cd sp
   ```

2. Edit `webdav.yaml`: set usernames, passwords, and per-user directories under `/data` so user data is separate.

3. Start the stack:

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

4. Open [http://127.0.0.1](http://127.0.0.1) for the app. In the app, set up sync with WebDAV base URL: `http://127.0.0.1/webdav/`.

## Other Docker Options

You can pass environment variables to the app container to prefill WebDAV (or other sync) settings on the Settings page. See `docker-compose.yaml` in the repository for the list of variables.

## Related

- [[4.23-Managing-Your-Data]] (sync and backups)
- [[2.08-Choose-Sync-Backend]]
