Repolode
Submit
timothepoznanski

timothepoznanski/poznote

A free, self-hosted note-taking app with rich text and Markdown notes, task lists, a diary, and sharing, offered as an alternative to Notion and Obsidian.

Open-source alternative to:NotionObsidianEvernote

View on GitHubWebsite
Stars
948
Forks
45
Open issues
2
Last commit
2 days ago

What is it?

Poznote is a self-hosted, open-source note-taking web app that runs in Docker. It supports two main note formats: rich text notes edited WYSIWYG and saved as HTML files, and Markdown notes with real-time preview, Mermaid diagrams and LaTeX math. Notes are organized in folders and workspaces, with shortcuts that let one note appear in several places.

Beyond notes, Poznote includes task lists with due dates, reminders and a dedicated Tasks page, a daily diary view, and revision history that keeps earlier versions of a note for comparison and restore. Users can authenticate with local accounts, two-factor TOTP, or OIDC single sign-on, and apps can use per-client app passwords to reach the REST API. An MCP server is also provided for AI clients.

The official image is multi-arch (amd64 and arm64), so it runs on Linux, Windows and macOS through Docker Desktop, as well as on devices such as Raspberry Pi and NAS systems. A rootless image variant and a Helm chart for Kubernetes are also available.

Key features

  • 01Rich text and Markdown notes, with Mermaid diagrams and LaTeX math in Markdown.
  • 02Task lists with due dates, reminders, and a Tasks page with filters and a calendar view.
  • 03Revision history with diff comparison and one-click restore.
  • 04Daily diary with board and journal views.
  • 05Local accounts with TOTP two-factor authentication, plus OIDC single sign-on.
  • 06REST API with app passwords, and an MCP server for AI clients.

Use cases

  • Replacing a cloud note app with a self-hosted instance that keeps your data on your own server.
  • Keeping personal notes, daily journal entries and to-do lists in one place.
  • Maintaining a team wiki or shared task lists with public edit links.
  • Running a private notes server on a Raspberry Pi or NAS.

Quick start

  1. 1

    Create a new directory

    mkdir poznote
  2. 2

    Navigate into the directory

    cd poznote
  3. 3

    Download the environment file

    curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template
  4. 4

    Download the Docker Compose configuration file

    curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml

Things to know

  • Requires Docker, with Docker Desktop on Windows and macOS.
  • Default admin credentials must be changed after the first login.

Topics

#note-taking#self-hosted#markdown#docker#todo-list#wiki#diary#php#documentation#free

FAQ

What is poznote?
A free, self-hosted note-taking app with rich text and Markdown notes, task lists, a diary, and sharing, offered as an alternative to Notion and Obsidian. Poznote is a self-hosted, open-source note-taking web app that runs in Docker. It supports two main note formats: rich text notes edited WYSIWYG and saved as HTML files, and Markdown notes with real-time preview, Mermaid diagrams and LaTeX math. Notes are organized in folders and workspaces, with shortcuts that let one note appear in several places.
Is poznote free to use? What license does it have?
poznote is open source under the MIT license. Check the license terms before using it in commercial products.
Is poznote still maintained?
Actively maintained. The last commit to poznote was on Oct 18, 2026.
What can I use poznote for?
Replacing a cloud note app with a self-hosted instance that keeps your data on your own server. Keeping personal notes, daily journal entries and to-do lists in one place. Maintaining a team wiki or shared task lists with public edit links. Running a private notes server on a Raspberry Pi or NAS.
How do I install poznote?
Create a new directory: mkdir poznote Navigate into the directory: cd poznote Download the environment file: curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template Download the Docker Compose configuration file: curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml
Where can I get poznote?
The source code and installation instructions are on GitHub: https://github.com/timothepoznanski/poznote

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects