tududi

Tasks, projects and notes organised by areas, with a Telegram bot

  • ghcr.io/hsinghhira/tududi:1.0.1
  • v2.1.1
  • Updated 21 Nov 2026
  • port 6763
  • amd64 · arm64
  • Productivity
  • 3.6k stars

Screenshots

tududi screenshot 1: Light modetududi screenshot 2: Dark mode

Open the app

Web UI

http://localhost:6763/

About tududi

tududi keeps your tasks, projects and notes in one place. Group projects into areas of your life, see what is due today, and add tasks from your phone. PostgreSQL is built in, so it is one container with nothing else to set up.

Features

  • Tasks with due dates, priorities, repeats and subtasks
  • Projects with tasks and notes, grouped into areas
  • Today view and a daily overview of what is due
  • Add tasks from Telegram, and sync with CalDAV apps
  • Installable on your phone, works offline
  • Sign in with OIDC (Pocket ID, Authentik), in 26 languages

How to use

  1. Open tududi from your dashboard.
  2. Sign in with the email and the password from the app's logs (the box marked CREDENTIALS).
  3. Change your password under Profile.
  4. Make an area, a project, and add your first tasks.
  5. Check the Today view each morning.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6763. The first account is TUDUDI_USER_EMAIL ([email protected] unless you change it) with a password made on first start, shown in the app's logs in the box marked CREDENTIALS and saved in /DATA/AppData/tududi/data/.admin_password. Both are only used while tududi has no users yet. Set BASE_URL to the address you use when you turn on email or sign-in with OIDC. Those and the other settings are in the Variables tab and are added in the app settings. The first start takes about 2 minutes.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
PUID$PUIDThe user that owns the files tududi writes. It is filled in by ZimaOS. Leave it.
PGID$PGIDThe group that owns the files tududi writes. It is filled in by ZimaOS. Leave it.
TUDUDI_USER_EMAIL[email protected]The email of the first account. Only used while tududi has no users yet.
TUDUDI_USER_PASSWORD—The first account's password. Leave it empty and one is made for you: it is shown in the app's logs, in the box marked CREDENTIALS. Change it later in tududi itself.

Server

VariableDefault valueDescription
BASE_URL—The address people open tududi at, like http://192.168.1.20:6763 or https://tasks.example.com. Needed for sign-in with OIDC and for links in emails.
TUDUDI_ALLOWED_ORIGINS—Other sites allowed to call tududi's API from a browser, comma separated. Not needed for tududi itself.
TUDUDI_TRUST_PROXYfalseSet to true when tududi is behind a reverse proxy.
TUDUDI_SESSION_SECRET—The key that signs sign-in cookies. It is made on first start and kept in /data/secrets.env. Only set it to use your own.
FILE_UPLOAD_LIMIT_MB10The biggest attachment people can upload, in MB.

Sign-up and accounts

VariableDefault valueDescription
PASSWORD_AUTH_ENABLEDtrueSet to false to turn off email and password sign-in, so people only sign in with OIDC.

Email (SMTP)

VariableDefault valueDescription
ENABLE_EMAILfalseSet to true to send emails: password resets and invites.
EMAIL_SMTP_HOST—Your email server, like smtp.gmail.com.
EMAIL_SMTP_PORT587Your email server port, usually 587 or 465.
EMAIL_SMTP_SECUREfalseSet to true for port 465.
EMAIL_SMTP_USERNAME—The user name for your email server.
EMAIL_SMTP_PASSWORD—The password for your email server.
EMAIL_FROM_ADDRESS—The address emails are sent from.
EMAIL_FROM_NAMETududiThe name emails are sent from.

Sign in with OIDC

VariableDefault valueDescription
OIDC_ENABLEDfalseSet to true to sign in with Pocket ID, Authentik, Google or another OIDC provider. Also set BASE_URL. You can set providers up in Profile instead.
OIDC_PROVIDER_NAME—The name on the sign-in button, like Pocket ID.
OIDC_PROVIDER_SLUG—A short id for the provider, like pocketid.
OIDC_ISSUER_URL—The provider's address, like https://id.example.com.
OIDC_CLIENT_ID—The client ID from your provider.
OIDC_CLIENT_SECRET—The client secret from your provider.
OIDC_SCOPEopenid profile emailThe scopes to ask for.
OIDC_AUTO_PROVISIONtrueSet to false so only people who already have an account can sign in with OIDC.

Features

VariableDefault valueDescription
TELEGRAM_ENABLEDfalseSet to true to show the Telegram bot settings, so people can add tasks from Telegram.
CALDAV_ENABLEDfalseSet to true to sync tasks with CalDAV apps and servers.
CALDAV_ALLOW_PRIVATE_HOSTSfalseSet to true to sync with CalDAV servers on your own network, like Nextcloud or Radicale on your ZimaOS.

AI

VariableDefault valueDescription
LLM_API_KEY—An OpenAI (or compatible) API key for the daily brief and task insights. Each user can also set their own in Profile.
LLM_BASE_URLhttps://api.openai.com/v1The API address, for example your Ollama server's /v1.
LLM_MODELgpt-4o-miniThe model to use.
docker-compose.yml
name: tududi

services:
  tududi:
    image: ghcr.io/hsinghhira/tududi:1.0.1
    container_name: tududi
    restart: unless-stopped
    stop_grace_period: 90s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - PUID=$PUID
      - PGID=$PGID
      - [email protected]
      - TUDUDI_USER_PASSWORD=
    ports:
      - target: 3002
        published: "6763"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/uploads
        target: /app/uploads
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/AppData/$AppID/backups
        target: /app/backups
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3002/api/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1024M
        reservations:
          cpus: "0.10"
          memory: 256M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tududi/icon.png
    x-casaos:
      id: com.icestore.tududi
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: PUID
          description:
            en_US: >-
              The user that owns the files tududi writes. It is filled in by
              ZimaOS. Leave it.
        - container: PGID
          description:
            en_US: >-
              The group that owns the files tududi writes. It is filled in by
              ZimaOS. Leave it.
        - container: TUDUDI_USER_EMAIL
          description:
            en_US: >-
              The email of the first account. Only used while tududi has no
              users yet.
        - container: TUDUDI_USER_PASSWORD
          description:
            en_US: >-
              The first account's password. Leave it empty and one is made
              for you: it is shown in the app's logs, in the box marked
              CREDENTIALS. Change it later in tududi itself.
      ports:
        - container: "3002"
          description:
            en_US: tududi web UI, API and CalDAV, published on host as 6763
      volumes:
        - container: /data
          description:
            en_US: >-
              The PostgreSQL database with every task, note and user, and
              secrets.env with this install's own session secret and
              database password. Back it up.
        - container: /app/uploads
          description:
            en_US: >-
              Attachments, avatars and project images. Back it up.
        - container: /app/backups
          description:
            en_US: >-
              Backups you make in tududi's settings.

x-casaos:
  id: com.icestore.tududi
  architectures:
    - amd64
    - arm64
  main: tududi
  author: HSinghHira
  category: Productivity
  developer: Chris Veleris
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tududi/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tududi/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tududi/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tududi/screenshot-2.png
  title:
    en_US: tududi
  tagline:
    en_US: Tasks, projects and notes organised by areas, with a Telegram bot
  description:
    en_US: >-
      tududi keeps your tasks, projects and notes in one place. Group
      projects into areas of your life, see what is due today, and add tasks
      from your phone. PostgreSQL is built in, so it is one container with
      nothing else to set up.


      **Features**


      - Tasks with due dates, priorities, repeats and subtasks

      - Projects with tasks and notes, grouped into areas

      - Today view and a daily overview of what is due

      - Add tasks from Telegram, and sync with CalDAV apps

      - Installable on your phone, works offline

      - Sign in with OIDC (Pocket ID, Authentik), in 26 languages


      **How to use?**


      1. Open tududi from the ZimaOS dashboard.

      2. Sign in with the email and the password from the app's logs (the
         box marked CREDENTIALS).

      3. Change your password under Profile.

      4. Make an area, a project, and add your first tasks.

      5. Check the Today view each morning.
  tips:
    before_install:
      en_US: >-
        1. Set TUDUDI_USER_EMAIL to your email if you like.


        2. More settings, like email, sign-in with OIDC and AI, are listed
           on the tududi page at https://icestore.hsinghhira.me/app/tududi/
           (Variables tab). You can add them now or later in the app
           settings.


        3. Start the installation. The first start takes about 2 minutes.


        4. Open the app's logs. Find the box marked CREDENTIALS. It has the
           email and password.


        5. Open http://[ZIMAOS-IP-ADDRESS]:6763 and sign in.
  index: /
  port_map: "6763"
  scheme: http
  is_uncontrolled: false
  version: "2.1.1"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - Added the PostgreSQL extensions package (pg_trgm and friends), the same fix as PLANKA (image 1.0.1)
      - First IceStore release, on port 6763
      - Built on chrisvel/tududi 2.1.1, with PostgreSQL 16 added inside the same container
      - Each install makes its own session secret, database password and first account password on first start; the login is in the CREDENTIALS box in the logs
  repo: "https://github.com/chrisvel/tududi"
  support: "https://github.com/chrisvel/tududi/issues"
  docs: "https://github.com/chrisvel/tududi/tree/main/docs"

Install tududi

Something not working with tududi?

Report it so it gets fixed, or ask for an app that is not here yet.

More Productivity apps

See all