taskwarrior-web-portal

概述

A web UI for Taskwarrior 3.x, packaged for Unraid. Browse, create, edit, and complete tasks from your browser without touching the CLI. Task data lives on your Unraid share and is never sent anywhere unless you opt in to sync. Optionally pairs with the taskchampion-sync-server Community App to sync tasks across multiple devices — all encryption happens client-side, the sync server never sees plaintext. Runs fully local with no sync server if preferred. WARNING: This app has no built-in authentication. It is designed for trusted LAN access only. If you intend to expose it outside your local network, place it behind a reverse proxy with authentication — for example Nginx Proxy Manager with HTTP Basic Auth, or a Cloudflare Tunnel with Authelia or Authentik in front.

要求

Taskwarrior 3.x is bundled in the image — nothing to install separately. On first start the container generates a unique client UUID. You can find it in the container log (Unraid Docker tab > Log icon) or on the web portal's config page (cog icon, top right). If you are syncing across multiple devices, all devices must use the same UUID — set the Sync Client ID field to match your existing device's UUID so they share the same task database on the server. To add UDA definitions, context definitions, journal settings, or any other Taskwarrior settings, edit /config/taskrc — add your settings below the end marker line. The container-managed block at the top of that file is regenerated on each start, but your settings below the marker are never touched.

运行时参数

网络用户界面: http://[IP]:[PORT:5050]/
网络: bridge
外壳: sh
特权: false
额外参数: --restart=unless-stopped

模板配置

WebUI PortPorttcp

Host port for the web UI. The default is 5050; change it here if that port is already in use on your server.

目标: 5050
默认值: 5050
价值: 5050

ConfigPathrw

Persistent storage for your task data, client UUID, and config. Back this path up — it is the only copy of your tasks.

目标: /config
默认值: /mnt/user/appdata/taskwarrior-web-portal
价值: /mnt/user/appdata/taskwarrior-web-portal

PUIDVariable

User ID the process runs as. Defaults to Unraid's nobody user (99). Set to your own UID (run `id -u` in the Unraid terminal) if you want task files owned by your user account.

默认值: 99
价值: 99

PGIDVariable

Group ID the process runs as. Defaults to Unraid's users group (100).

默认值: 100
价值: 100

Disable Host CheckVariable

Set to 1 to disable the host/origin allowlist check. Recommended for Docker deployments where the external hostname or port is not known. Set to 0 and use Allowed Hosts below if you want stricter control.

目标: TWP_DISABLE_HOST_CHECK
默认值: 1
价值: 1

Allowed HostsVariable

Only used when Disable Host Check is 0. Your Unraid server's LAN IP address, e.g. 192.168.1.10. Separate multiple entries with commas.

目标: TWP_ALLOWED_HOSTS

Secure CookiesVariable

Set to 1 if this container is behind a TLS-terminating reverse proxy (e.g. Nginx Proxy Manager with HTTPS). Adds the Secure flag to the CSRF cookie so it is only transmitted over HTTPS. Leave at 0 for plain HTTP LAN access.

目标: TWP_SECURE_COOKIES
默认值: 0
价值: 0

Sync Server URLVariable

Optional. Full URL of your TaskChampion Sync Server, e.g. http://192.168.1.10:8007. Leave empty to run local-only with no sync.

目标: TWC_SERVER_URL

Sync PassphraseVariable

Encryption passphrase for your task data. Required when a Sync Server URL is set. Tasks are encrypted before leaving this container — the sync server never sees plaintext. Use a strong passphrase and store it safely; it cannot be recovered if lost.

目标: TWC_PASSPHRASE

Sync Client IDVariable

The client UUID used to identify your task database on the sync server. IMPORTANT: all devices that should share the same tasks must use the same UUID here. Copy the UUID from your other device's taskrc (rc.sync.server.client_id) or from the web portal config page. Leave empty to auto-generate a new UUID on first start (local-only or first device).

目标: TWC_CLIENT_ID

Bugwarrior BinaryVariable

Optional. Absolute path to the bugwarrior binary inside the container, e.g. /venv/bin/bugwarrior. Only needed if you have installed bugwarrior in a custom location or a mounted virtualenv. Leave empty to let the portal detect it automatically via PATH and common install directories.

目标: BUGWARRIOR_BIN

类别

Productivity Tools > Utilities

链接

模板支持登记处 Pro连接

详细信息

存储库

ghcr.io/furan917/taskwarrior-web-portal-docker:latest

登记处

https://github.com/furan917/taskwarrior-web-portal-docker/pkgs/container/taskwarrior-web-portal-docker

最后更新2026-05-31

初见2026-05-16

在Unraid 上运行 taskwarrior-web-portal 。

taskwarrior-web-portal 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS