# Taskwarrior Web Portal

Taskwarrior Web Portal is a self-hosted productivity app. A web UI for Taskwarrior 3.x, packaged for Unraid. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3374/taskwarrior-web-portal

## Description

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.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

46/100 (Fair), based on 3 of 4 factors.
- Maintained: 69 (last commit 59 days ago)
- Popular: 17 (6 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/taskwarrior-web-portal-1ag8n1c0jhshbg?q=taskwarrior-web-portal

## Common questions

### How do I make the portal reachable from other machines on my local network?

Set TWP_BIND_HOST to 0.0.0.0 and list the allowed hostnames or IPs in TWP_ALLOWED_HOSTS. Do not include the port in TWP_ALLOWED_HOSTS, because the port is appended automatically.

### Where does Taskwarrior Web Portal store or write task data?

It reads and writes through the existing task CLI on the host, which serialises against ~/.task/taskchampion.sqlite3.

### How should I add authentication if I expose it outside my LAN?

The portal has no built-in authentication and is intended for trusted LAN use only. If you must reach it outside your LAN, put it behind a reverse proxy with authentication, such as Nginx Proxy Manager with HTTP Basic Auth or a Cloudflare Tunnel with Authelia or Authentik.

### How do I point the portal at a non-standard bugwarrior install?

Set BUGWARRIOR_BIN to the absolute path of the bugwarrior binary. If unset, it is auto-detected from PATH and common install directories.

### Does the list auto-refresh overwrite changes I am typing?

The list view auto-refreshes every 30 seconds, but it pauses while you are editing so mid-flight inputs aren't clobbered.

---
Source: Our Local Host (https://ourlocalhost.com/app/3374/taskwarrior-web-portal), the self-hosted and open-source app directory.
