Repolode
Submit
chrisvel

chrisvel/tududi

Self-hosted or hosted task and project manager for organizing personal and team work with tasks, projects, notes, areas and recurring tasks.

Open-source alternative to:Todoist

View on GitHubWebsite
Stars
3,519
Forks
287
Open issues
18
Last commit
21 hours ago

What is it?

tududi is a task and life-organization app built around a clear hierarchy: areas group projects, projects contain tasks and notes, and tags cut across both. Tasks can be filtered into Today, Upcoming and Someday views, sorted by due date or priority, and broken into subtasks with progress tracking.

Recurring tasks support daily, weekly, monthly and last-day-of-month patterns, with custom intervals and optional end dates. The app runs in Docker with SQLite by default or PostgreSQL for larger deployments. It includes OIDC/SSO login, CalDAV sync with clients such as Apple Reminders and Thunderbird, a REST API with personal access tokens, and an installable PWA that caches content offline.

Families and small teams can share projects and areas, use groups and roles, and assign tasks to members or to contacts without an account.

Key features

  • 01Hierarchical organization of areas, projects, tasks, notes and tags.
  • 02Recurring tasks with daily, weekly, monthly and custom-interval patterns.
  • 03Subtasks with progress tracking.
  • 04CalDAV sync with clients like Apple Reminders, Thunderbird and tasks.org.
  • 05OIDC/SSO login with providers such as Google, Okta and Keycloak.
  • 06REST API with personal access tokens and Swagger docs.

Use cases

  • Running a self-hosted personal GTD system on a home server or NAS.
  • Coordinating household tasks with family members and children who lack email accounts.
  • Syncing tasks from a self-hosted tool into native reminder apps via CalDAV.
  • Automating task creation from scripts through the REST API.

Quick start

  1. 1

    Pull the Docker image

    docker pull chrisvel/tududi:latest
  2. 2

    Run the container with admin credentials and a session secret, then open http://localhost:3002

    docker run -e TUDUDI_USER_EMAIL=admin@example.com -e TUDUDI_USER_PASSWORD=your-secure-password -e TUDUDI_SESSION_SECRET=$(openssl rand -hex 64) -v ~/tududi_db:/app/db -v ~/tududi_uploads:/app/uploads -v ~/tududi_backups:/app/backups -p 3002:3002 -d chrisvel/tududi:latest

Things to know

  • Self-hosting requires Docker setup and managing your own data volumes and secrets.
  • Upgrading from v1.1.x requires updating volume paths or data may be lost.

In collections

Self-hosted apps

Topics

#gtd#task-management#todo#self-hosted#project-management#recurring-tasks#nodejs#react#expressjs#get-things-done

FAQ

What is tududi?
Self-hosted or hosted task and project manager for organizing personal and team work with tasks, projects, notes, areas and recurring tasks. tududi is a task and life-organization app built around a clear hierarchy: areas group projects, projects contain tasks and notes, and tags cut across both. Tasks can be filtered into Today, Upcoming and Someday views, sorted by due date or priority, and broken into subtasks with progress tracking.
Is tududi free to use? What license does it have?
tududi is open source under the MIT license. Check the license terms before using it in commercial products.
Is tududi still maintained?
Actively maintained. The last commit to tududi was on Nov 6, 2026.
What can I use tududi for?
Running a self-hosted personal GTD system on a home server or NAS. Coordinating household tasks with family members and children who lack email accounts. Syncing tasks from a self-hosted tool into native reminder apps via CalDAV. Automating task creation from scripts through the REST API.
How do I install tududi?
Pull the Docker image: docker pull chrisvel/tududi:latest Run the container with admin credentials and a session secret, then open http://localhost:3002: docker run -e TUDUDI_USER_EMAIL=admin@example.com -e TUDUDI_USER_PASSWORD=your-secure-password -e TUDUDI_SESSION_SECRET=$(openssl rand -hex 64) -v ~/tududi_db:/app/db -v ~/tududi_uploads:/app/uploads -v ~/tududi_backups:/app/backups -p 3002:3002 -d chrisvel/tududi:latest
Where can I get tududi?
The source code and installation instructions are on GitHub: https://github.com/chrisvel/tududi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects