tududi
A calm, open system for organizing life and work. Tasks, projects, notes, areas, and smart workflows - self-hosted or hosted.
What is it?
What it is
A productivity and life management application designed to organize tasks, projects, areas, notes, and tags using a hierarchical structure.
Why it exists
To provide a simple, focused, and private way to manage personal and professional productivity through features like smart recurring tasks, Telegram integration, and CalDAV synchronization.
Who should use it
Teams building with TypeScript who want an open-source, self-hosted option.
Who should avoid it
Teams that need a fully managed SaaS with enterprise SLAs out of the box.
How it works
A quick walkthrough in plain English
How tududi works
Step 1 of 3
You interact with it
Open tududi, send a request, or connect it to your stack.
Features
Advantages
- Highly flexible task scheduling and recurrence logic
- Seamless integration with existing productivity ecosystems via CalDAV
- Enterprise-ready authentication options
- Extensible through a comprehensive REST API
- Privacy-focused with self-hosting capabilities via Docker
Disadvantages
- Requires manual volume path updates when upgrading from v1.1.x to v1.2.x
- Self-hosting requires technical knowledge of Docker and reverse proxies
Installation
cloud
purchase a hosted subscription for a hassle-free, managed solution.
docker
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/db \ -v ~/tududi_uploads:/app/uploads \ -p 3002:3002 \ -d chrisvel/tududi:latest
native
git clone https://github.com/chrisvel/tududi.git cd tududi npm install npm run backend:dev npm run frontend:dev
compose
docker-compose down # Update volumes to use new paths: vols: -./tududi_db:/app/db -./uploads:/app/uploads docker-compose up -d
FAQ
How can I quickly get tududi running on my local machine?
The fastest way is using Docker. You can pull the latest image and run it with a single command: `docker pull chrisvel/tududi:latest` followed by a `docker run` command specifying your admin email, password, and volume mounts for database and uploads.
Can I sync my tasks with external calendar or task applications?
Yes, tududi supports the industry-standard CalDAV protocol. This allows for bidirectional synchronization with clients like Apple Reminders, tasks.org, Thunderbird, and Evolution, as well as servers like Nextcloud or Baikal.
Does tududi support Single Sign-On (SSO) for enterprise use?
Yes, it features enterprise-ready OIDC/SSO authentication. It supports multiple providers including Google, Okta, Keycloak, Authentik, Azure AD, and any other OIDC-compliant provider, including automatic user provisioning and admin role assignment.
How does the recurring task system work?
The system supports multiple patterns (daily, weekly, monthly, etc.) and offers smart parent-child linking. You can choose to repeat tasks based on the due date or the completion date, and you can edit recurrence settings directly from any generated task instance.
Can I integrate tududi with my own custom tools or automations?
Yes, tududi provides a comprehensive REST API (versioned at `/api/v1`) with Swagger documentation available at `/api-docs`. You can generate personal API keys through the web interface to perform CRUD operations on tasks, projects, notes, and areas.
I am upgrading from v1.1.x to v1.2.x. What should I watch out for?
In v1.2.0, the Docker volume mount path changed from `/app/backend/db` to `/app/db`. You must update your `docker-compose.yml` volume mappings to the new paths to ensure your data persists across container recreations.
Featured in Videos
YouTube tutorials and walkthroughs for tududi
Alternatives
Similar projects ranked by category, topics, and text overlap.
