Skip to main content
Version: Next (main)

PeckList

PeckList is a self-hosted task and calendar app: lists, subtasks, tags, dates and a calendar you drag tasks onto, shared with the people you choose. It works offline on every device and syncs when it can. One small server (a Docker container, or a native program on Linux and Windows) serves the app and keeps everyone's data, in SQLite or PostgreSQL.

Status: before 1.0. In daily use, but a minor version may still change things: every change you need to act on is under Breaking changes in the changelog. Keep backups.

A list of tasks with the task details open beside it

The week calendar with tasks placed on it

What it does​

  • Tasks with subtasks, nested tags, priorities, start and due dates, times and time spans, rich notes and checklists. Type a whole task in one line: Call the vet tomorrow 3pm #pets !high.
  • Views: Today, Upcoming, Due dates, All, Closed, Assigned to me, Shared with me, saved filters, search, and a calendar (a continuous month, and 1 to 14 days on a time grid) to drag tasks in, move them and stretch them.
  • Offline first: an installable web app (PWA) that keeps working without a connection and merges changes from every device without conflicts.
  • Sharing: friends, groups and shared lists; assign tasks to people or groups.
  • For the person running it: single sign-on with any OpenID Connect provider, roles and server groups, scheduled backups and restore, per-person export, access and event logs, logs to Loki, Elasticsearch, Graylog, OpenTelemetry or syslog, usage stats, and settings from the environment, a file or the admin page.

Where to start​

You want toRead
Try it in two minutesQuick start
Run it for real with DockerDocker Compose, then reverse proxy and HTTPS
Run it without DockerLinux or Windows
Sign in with Authentik, Pocket ID, Keycloak...Single sign-on
Change a settingHow settings work and all settings
Back up, move or restoreBackups and restore
Fix somethingTroubleshooting
Move from TickTick or TodoistMoving from TickTick or Todoist
Put it on your Android phoneThe Android app
Decide whether it is for youWhy PeckList and the comparison

Getting help​

See getting help. In short: open an issue on GitLab, and for a bug (how to report one) attach a debug dump: it carries logs, settings and versions but no task content, passwords or keys. Report security problems privately as described in SECURITY.md.