Vikunja

To-do app with lists, kanban, Gantt and shared projects

  • ghcr.io/hsinghhira/vikunja:1.0.1
  • v2.8.0
  • Updated 21 Nov 2026
  • port 6761
  • amd64 · arm64
  • Productivity
  • 6.1k stars

Screenshots

Vikunja screenshot 1: OverviewVikunja screenshot 2: ListVikunja screenshot 3: KanbanVikunja screenshot 4: GanttVikunja screenshot 5: Task details

Open the app

Web UI

http://localhost:6761/

API docs

http://localhost:6761/api/v1/docs

About Vikunja

Vikunja is a to-do app for you, your family or your team. Put tasks in projects and look at them as a list, a kanban board, a table or a Gantt chart. The database is built in, so it is one container with nothing else to set up.

Features

  • List, kanban, table and Gantt views of every project
  • Due dates, reminders, repeating tasks, labels and priorities
  • Quick add with words like "tomorrow" or "*shopping"
  • Share projects with people, teams or a public link
  • Attachments, comments and task relations
  • CalDAV sync with your phone's calendar and reminders, and a REST API

How to use

  1. Open Vikunja from your dashboard.
  2. Click Create account and make your account.
  3. Make a project and add your first tasks.
  4. Switch between List, Kanban, Table and Gantt at the top.
  5. When everyone has an account, set VIKUNJA_SERVICE_ENABLEREGISTRATION to false in the app settings.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6761. There is no admin account: make yours with Create account, then set VIKUNJA_SERVICE_ENABLEREGISTRATION=false. Set VIKUNJA_SERVICE_PUBLICURL to the address you use (like http://[ZIMAOS-IP-ADDRESS]:6761) when you want working links in emails or CalDAV on your phone. A secret is made on first start, so people stay signed in across restarts. Email and the other settings are in the Variables tab and are added in the app settings. Sign-in with OpenID is set up with a config file; see the Vikunja docs. It is ready in under a minute.

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 and used for due dates and reminders.
VIKUNJA_SERVICE_ENABLEREGISTRATIONtruetrue lets anyone make an account on the sign-in page. Set it to false after you and your people have made accounts.
VIKUNJA_SERVICE_PUBLICURL—The address people open Vikunja at, like http://[ZIMAOS-IP-ADDRESS]:6761 or https://tasks.example.com. Leave it empty to use Vikunja in the browser; set it for links in emails, CalDAV and sign-in with OpenID.

Server

VariableDefault valueDescription
VIKUNJA_SERVICE_SECRET—The key that signs sign-ins. It is made on first start and kept in the data folder as .service_secret. Only set it to use your own.
VIKUNJA_SERVICE_TIMEZONE—The time zone for reminders, like Europe/Berlin. Leave it out to use TZ.

Features

VariableDefault valueDescription
VIKUNJA_SERVICE_ENABLECALDAVtrueSet to false to turn off CalDAV sync.
VIKUNJA_SERVICE_ENABLELINKSHARINGtrueSet to false so nobody can share a project with a public link.
VIKUNJA_SERVICE_ENABLETASKATTACHMENTStrueSet to false to turn off file attachments on tasks.
VIKUNJA_SERVICE_ENABLETASKCOMMENTStrueSet to false to turn off comments on tasks.

Sign-up and accounts

VariableDefault valueDescription
VIKUNJA_SERVICE_ENABLETOTPtrueSet to false to turn off two-factor sign-in.
VIKUNJA_SERVICE_ENABLEUSERDELETIONtrueSet to false so people can't delete their own account.
VIKUNJA_SERVICE_ENABLEPUBLICTEAMSfalseSet to true to let teams be found and joined by anyone on this Vikunja.

Email (SMTP)

VariableDefault valueDescription
VIKUNJA_SERVICE_ENABLEEMAILREMINDERStrueSet to false to stop reminder emails. Needs the mailer below.
VIKUNJA_MAILER_ENABLEDfalseSet to true to send emails: reminders, password resets and invites.
VIKUNJA_MAILER_HOST—Your email server, like smtp.gmail.com.
VIKUNJA_MAILER_PORT587Your email server port, usually 587 or 465.
VIKUNJA_MAILER_USERNAMEuserThe user name for your email server.
VIKUNJA_MAILER_PASSWORD—The password for your email server.
VIKUNJA_MAILER_FROMEMAILmail@vikunjaThe address emails are sent from.
VIKUNJA_MAILER_FORCESSLfalseSet to true for port 465.

Files

VariableDefault valueDescription
VIKUNJA_FILES_MAXSIZE20MBThe biggest file people can attach, like 100MB.

New users

VariableDefault valueDescription
VIKUNJA_DEFAULTSETTINGS_EMAIL_REMINDERS_ENABLEDfalseSet to true so new users get reminder emails without turning them on.
VIKUNJA_DEFAULTSETTINGS_WEEK_START0The first day of the week for new users: 0 is Sunday, 1 is Monday.
VIKUNJA_DEFAULTSETTINGS_LANGUAGE—The language for new users, like de-DE or fr-FR. Leave it out to follow the browser.

Logs

VariableDefault valueDescription
VIKUNJA_LOG_LEVELINFOHow much Vikunja writes to the log: CRITICAL, ERROR, WARNING, INFO or DEBUG.
docker-compose.yml
name: vikunja

services:
  vikunja:
    image: ghcr.io/hsinghhira/vikunja:1.0.1
    container_name: vikunja
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - VIKUNJA_SERVICE_ENABLEREGISTRATION=true
      - VIKUNJA_SERVICE_PUBLICURL=
    ports:
      - target: 3456
        published: "6761"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3456/api/v1/info"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 60s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 512M
        reservations:
          cpus: "0.05"
          memory: 64M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/icon.png
    x-casaos:
      id: com.icestore.vikunja
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone and
              used for due dates and reminders.
        - container: VIKUNJA_SERVICE_ENABLEREGISTRATION
          description:
            en_US: >-
              true lets anyone make an account on the sign-in page. Set it to
              false after you and your people have made accounts.
        - container: VIKUNJA_SERVICE_PUBLICURL
          description:
            en_US: >-
              The address people open Vikunja at, like
              http://[ZIMAOS-IP-ADDRESS]:6761 or https://tasks.example.com.
              Leave it empty to use Vikunja in the browser; set it for links
              in emails, CalDAV and sign-in with OpenID.
      ports:
        - container: "3456"
          description:
            en_US: Vikunja web UI, API and CalDAV, published on host as 6761
      volumes:
        - container: /data
          description:
            en_US: >-
              The SQLite database (vikunja.db), task attachments (files) and
              .service_secret, this install's own key made on first start.
              Back it up.

x-casaos:
  id: com.icestore.vikunja
  architectures:
    - amd64
    - arm64
  main: vikunja
  author: HSinghHira
  category: Productivity
  developer: Vikunja
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-2.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-3.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-4.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/vikunja/screenshot-5.png
  title:
    en_US: Vikunja
  tagline:
    en_US: To-do app with lists, kanban, Gantt and shared projects
  description:
    en_US: >-
      Vikunja is a to-do app for you, your family or your team. Put tasks in
      projects and look at them as a list, a kanban board, a table or a Gantt
      chart. The database is built in, so it is one container with nothing
      else to set up.


      **Features**


      - List, kanban, table and Gantt views of every project

      - Due dates, reminders, repeating tasks, labels and priorities

      - Quick add with words like "tomorrow" or "*shopping"

      - Share projects with people, teams or a public link

      - Attachments, comments and task relations

      - CalDAV sync with your phone's calendar and reminders, and a REST API


      **How to use?**


      1. Open Vikunja from the ZimaOS dashboard.

      2. Click Create account and make your account.

      3. Make a project and add your first tasks.

      4. Switch between List, Kanban, Table and Gantt at the top.

      5. When everyone has an account, set
         VIKUNJA_SERVICE_ENABLEREGISTRATION to false in the app settings.
  tips:
    before_install:
      en_US: >-
        1. You can leave everything as it is.


        2. More settings, like email reminders and the upload size, are
           listed on the Vikunja page at
           https://icestore.hsinghhira.me/app/vikunja/ (Variables tab). You
           can add them now or later in the app settings.


        3. Start the installation. It is ready in under a minute.


        4. Open http://[ZIMAOS-IP-ADDRESS]:6761 and click Create account.


        5. After everyone has an account, set
           VIKUNJA_SERVICE_ENABLEREGISTRATION to false so strangers can't
           sign up.
  index: /
  port_map: "6761"
  scheme: http
  is_uncontrolled: false
  version: "2.8.0"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - Fixed "service.publicurl is required when cors.enable is true": CORS stays off until VIKUNJA_SERVICE_PUBLICURL is set (the web UI doesn't need it) (image 1.0.1)
      - First IceStore release, on port 6761
      - Built on vikunja/vikunja 2.8.0, with the SQLite database and attachments in one data folder
      - Each install makes its own VIKUNJA_SERVICE_SECRET on first start, so people stay signed in across restarts
  repo: "https://github.com/go-vikunja/vikunja"
  support: "https://github.com/go-vikunja/vikunja/issues"
  docs: "https://vikunja.io/docs/"

Install Vikunja

Something not working with Vikunja?

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

More Productivity apps

See all