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

docker run -d -p 8080:80 johannesjo/super-productivity:latest

Open http://127.0.0.1:8080. 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/):

   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. Name the two services explicitly — docker-compose.yaml also defines a db and a supersync service used only by the E2E test suite, which run in test mode and must never be started outside it:

   docker compose pull app webdav
   docker compose up -d app webdav
   

4. Open http://127.0.0.1:8080 for the app. In the app, set up sync with WebDAV base URL: http://127.0.0.1:2345/.

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