ContextQMD
Back to Super Productivity

2.13 Run With Docker

docs/wiki/2.13-Run-with-Docker.md

18.4.41.4 KB
Original Source

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. 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 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.

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