# tududi: Self-Hosted Task Management for Privacy, Control, and Efficiency

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/chrisvel-tududi
Generated for open source discovery and AI-assisted research.

tududi is a robust self-hosted task management solution designed for individuals and teams prioritizing privacy, control, and efficiency. It offers a comprehensive suite of features, including hierarchical task organization, smart recurring tasks, and seamless Telegram integration. With its open API and multi-language support, tududi provides a powerful platform to streamline productivity and manage projects effectively.

GitHub: https://github.com/chrisvel/tududi
OSRepos URL: https://osrepos.com/repo/chrisvel-tududi

## Summary

tududi is a robust self-hosted task management solution designed for individuals and teams prioritizing privacy, control, and efficiency. It offers a comprehensive suite of features, including hierarchical task organization, smart recurring tasks, and seamless Telegram integration. With its open API and multi-language support, tududi provides a powerful platform to streamline productivity and manage projects effectively.

## Topics

- task-management
- project-management
- gtd
- self-hosted
- typescript
- react
- nodejs
- productivity

## Repository Information

Last analyzed by OSRepos: Thu Feb 19 2026 08:01:25 GMT+0000 (Western European Standard Time)
Detail views: 6
GitHub clicks: 9

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

tududi is an open-source, self-hosted task management application that blends the simplicity required for personal use with the robust features needed for professional project organization. Built with privacy, control, and efficiency in mind, it empowers users to manage tasks, projects, areas, notes, and tags in a highly organized manner. Whether you're an individual looking to streamline your daily workflow or a team seeking a collaborative and private project management tool, tududi offers a flexible and powerful solution.

Key features include a clear hierarchical structure, intelligent recurring tasks, subtasks with progress tracking, multi-language support, and seamless integration with Telegram for quick task capture and daily digests. Its open API further allows for extensive customization and integration with other tools.

## Installation

Getting started with tududi is straightforward, especially using Docker. The following quick start command will pull the latest image and run the application, setting up an initial admin user and persistent volumes for your data.

bash
docker pull chrisvel/tududi:latest

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/backend/db \
  -v ~/tududi_uploads:/app/backend/uploads \
  -p 3002:3002 \
  -d chrisvel/tududi:latest


After running the command, navigate to [http://localhost:3002](http://localhost:3002) in your web browser and log in with the credentials you provided.

For detailed setup instructions, including reverse proxy configurations and development setup, refer to the official documentation.

## Examples

tududi provides a comprehensive REST API, allowing for integration with external tools and automation workflows. Here are quick examples of how to interact with the API using `curl` to retrieve and create tasks.

First, ensure you have generated a personal API key through the tududi web interface for secure access.

**Get all tasks:**

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
     http://localhost:3002/api/v1/tasks


**Create a new task:**

bash
curl -X POST \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"name":"Complete API documentation","priority":"medium"}' \
     http://localhost:3002/api/v1/task


The API supports complete CRUD operations for tasks, projects, notes, and areas, along with features for recurring tasks, subtasks, and tag management. Full API documentation is available at `/api-docs` after authentication.

## Why Use tududi?

tududi stands out as a powerful task and project management solution for several compelling reasons:

*   **Privacy and Control:** Being self-hosted, tududi gives you complete ownership and control over your data, ensuring privacy without reliance on third-party cloud services.
*   **Comprehensive Features:** From basic task creation to complex recurring tasks, subtasks, project sharing, notes, tags, and area categorization, tududi covers all aspects of personal and team productivity.
*   **Smart Recurring Tasks:** Its advanced system for recurring tasks, including multiple patterns, completion-based recurrence, and smart parent-child linking, simplifies routine management.
*   **Seamless Integrations:** With Telegram integration for quick capture and daily digests, plus an open API for custom automations, tududi fits into diverse workflows.
*   **Multi-Language Support:** Available in 24 languages, it offers a truly global and accessible productivity experience.
*   **Active Development & Community:** The project is actively maintained, with a clear roadmap and a welcoming community for contributions and support.

## Links

*   **GitHub Repository:** [https://github.com/chrisvel/tududi](https://github.com/chrisvel/tududi){:target="_blank" rel="noopener noreferrer"}
*   **Official Documentation:** [https://docs.tududi.com](https://docs.tududi.com){:target="_blank" rel="noopener noreferrer"}
*   **Designing a Life Management System That Doesn't Fight Back:** [https://medium.com/@chrisveleris/designing-a-life-management-system-that-doesnt-fight-back-2fd58773e857](https://medium.com/@chrisveleris/designing-a-life-management-system-that-doesnt-fight-back-2fd58773e857){:target="_blank" rel="noopener noreferrer"}
*   **From Task to Table: How I Finally Got to the Korean Burger:** [https://medium.com/@chrisveleris/from-task-to-table-how-i-finally-got-to-the-korean-burger-01245a14d491](https://medium.com/@chrisveleris/from-task-to-table-how-i-finally-got-to-the-korean-burger-01245a14d491){:target="_blank" rel="noopener noreferrer"}
*   **Discord Community:** [https://discord.gg/fkbeJ9CmcH](https://discord.gg/fkbeJ9CmcH){:target="_blank" rel="noopener noreferrer"}
*   **Reddit Community:** [https://www.reddit.com/r/tududi/](https://www.reddit.com/r/tududi/){:target="_blank" rel="noopener noreferrer"}