Super Productivity

Overview

Time tracking and task management app, synced across workstations through OpenCloud.

Prerequisites

Super Productivity signs in to OpenCloud as its own service account, so create one in the Keycloak admin console (https://id-admin.yhkze.net, realm internal) first.

  1. Go to Users → Add user and fill in

    Field Value
    Username super_productivity
    Email [email protected]
    First name Super Productivity

    The srv+ prefix marks the address as a service account. Plus addressing keeps its mail landing in the regular inbox without needing a mailbox of its own.

  2. Under Groups → Join Group, add opencloud_service_group

    modules/features/opencloud.nix maps this group to the OpenCloud User role. Reference OpenCloud docs for the other groups.

  3. Under Credentials → Credential reset, send Update Password and Configure OTP; the email arrives in the srv inbox

Sync Setup

Sign in to OpenCloud as that account and:

  1. Create a data folder

  2. Generate an app token under Account → App Tokens → New

    Sync needs this token in place of the account password, since OpenCloud rejects regular login passwords on WebDAV connections

Client Setup

In Super Productivity → Settings → Sync → Configure Sync:

Field Value
Sync provider Nextcloud
Server URL https://cloud.yhkze.net
Username super_productivity
App Password generated app token
Sync Folder Path data

The provider list also offers plain WebDAV, but Super Productivity labels that option “not recommended / no support”, so Nextcloud is the one to pick. Both providers talk to the server over WebDAV, and OpenCloud implements the same WebDAV interface Nextcloud does, so the Nextcloud provider works against it. It also handles two things on its own: it builds the full storage path from the server URL and username, and it notices when a file changed on the server by reading a header OpenCloud sends with every response.