How to Install Poznote on Your Synology NAS

by

How to Install Poznote on Your Synology NAS

Poznote is a lightweight, open-source, self-hosted note-taking and personal knowledge management app that runs entirely in your browser while keeping your data under full control. It combines the simplicity of plain Markdown files stored on disk with modern editing features and some powerful visual tools. The backend is minimal, just PHP 8 and SQLite, which makes it extremely easy to deploy, especially through Docker. You get rich text and Markdown editing, Excalidraw whiteboards for quick sketches, Mermaid diagrams created from text, proper mathematical rendering with KaTeX, a flexible system of workspaces, folders and tags, full-text search, attachments, public sharing links, a complete backup/export system that produces nice offline-browsable ZIP archives, and even import support for Obsidian vaults and Standard Notes. In this step by step guide I will show you how to install PoznoteĀ on yourĀ Synology NAS using Docker and Portainer.

šŸ’”Note:Ā This guide works perfectly with the latest Poznote v3.0.2Ā release.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

InstallĀ Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

  • STEP 3

Go toĀ File StationĀ and open the docker folder. Inside the docker folder, create one new folder and name itĀ poznote. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Poznote Synology NAS Set up 1

  • STEP 4

Log into Portainer using your username and password. On the left sidebar in Portainer, click onĀ HomeĀ thenĀ Live connect. Follow the instructions in the image below.

Portainer Add Stack NAS 1

On the left sidebar in Portainer, click on StacksĀ thenĀ + Add stack. Follow the instructions in the image below.

Portainer Add Stack NAS 2

  • STEP 5

In the Name field type in poznote. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

services:
  poznote:
    image: ghcr.io/timothepoznanski/poznote:latest
    container_name: Poznote
    healthcheck:
      test: ["CMD-SHELL", "nc -z 127.0.0.1 80 || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 90s
    environment:
      SQLITE_DATABASE: /var/www/html/data/database/poznote.db
      POZNOTE_PASSWORD: mariushosting
      POZNOTE_SETTINGS_PASSWORD: mariushosting12345
      HTTP_WEB_PORT: 2999
      POZNOTE_OIDC_ENABLED: false
      POZNOTE_OIDC_PROVIDER_NAME: Provider Name
      POZNOTE_OIDC_ISSUER: OIDC issuer
      POZNOTE_OIDC_DISCOVERY_URL: Discovery URL
      POZNOTE_OIDC_CLIENT_ID: Client ID
      POZNOTE_OIDC_CLIENT_SECRET: Client Secret
      POZNOTE_OIDC_SCOPES: openid profile email
      POZNOTE_OIDC_REDIRECT_URI: POZNOTE_OIDC_REDIRECT_URI
      POZNOTE_OIDC_END_SESSION_ENDPOINT: POZNOTE_OIDC_END_SESSION_ENDPOINT
      POZNOTE_OIDC_POST_LOGOUT_REDIRECT_URI: POZNOTE_OIDC_POST_LOGOUT_REDIRECT_URI
      POZNOTE_OIDC_DISABLE_NORMAL_LOGIN: false
      POZNOTE_OIDC_DISABLE_BASIC_AUTH: false
      POZNOTE_DISABLE_SETTINGS_ACCESS: false
      POZNOTE_IMPORT_MAX_INDIVIDUAL_FILES: 50
      POZNOTE_IMPORT_MAX_ZIP_FILES: 300
    ports:
      - 2999:80
    volumes:
      - /volume1/docker/poznote:/var/www/html/data:rw
    restart: on-failure:5

Note: Before you paste the code above in the Web editor area below, change the value for POZNOTE_PASSWORD. Type in your own Poznote password. mariushosting is an example for a Poznote password. You will need this password later at STEP 9.
Note: Before you paste the code above in the Web editor area below, change the value for POZNOTE_SETTINS_PASSWORD. Type in your own Poznote Settings password. mariushosting12345 is an example for a Poznote Settings password. You will need this password later at STEP 11.

Poznote Synology NAS Set up 2

  • STEP 6

Scroll down on the page until you see a button namedĀ Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

Poznote Synology NAS Set up 3

  • STEP 7

If everything goes right, you will see the following message at the top right of your screen: ā€œSuccess Stack successfully deployedā€œ.

Portainer Success Stack NAS

  • STEP 8

Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guidesĀ forget to support my work, or justĀ ignoreĀ STEP 1. Iā€™ve been very honest about this aspect of my work since the beginning: I donā€™t run any ADS, I donā€™t require subscriptions, paid or otherwise, I donā€™t collect IPs, emails, and I donā€™t have any referral links from Amazon or other merchants. I also donā€™t have any POP-UPs or COOKIES. I have repeatedly been told over the years how much I have contributed to the community. Itā€™s something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.

  • STEP 9

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type inĀ http://Synology-ip-address:2999Ā If everything goes right, you will see the Poznote Login page. Type in the default username which is admin_change_me and the Password ( POZNOTE_PASSWORD) that you have previously added at STEP 5. Click Login. Follow the instructions in the image below.

Poznote Synology NAS Set up 4

  • STEP 10

Click the Settings icon. Follow the instructions in the image below.

Poznote Synology NAS Set up 5

  • STEP 11

A new pop up window will open. Type in your POZNOTE_SETTINS_PASSWORD that you have previously added at STEP 5. Click Access Settings. Follow the instructions in the image below.

Poznote Synology NAS Set up 6

  • STEP 12

Click User Management. Follow the instructions in the image below.

Poznote Synology NAS Set up 7

  • STEP 13

Click the edit icon. Follow the instructions in the image below.

Poznote Synology NAS Set up 8

  • STEP 14

Type in your own Username and Email address, then click Save. Click the Back to Settings tab. Follow the instructions in the image below.

Poznote Synology NAS Set up 9

  • STEP 15

Switch the theme from light to dark. Click Back to Notes. Follow the instructions in the image below.

Poznote Synology NAS Set up 10

  • STEP 16

Add your Note. Type in a slash / to access options. Follow the instructions in the image below.

Poznote Synology NAS Set up 11

  • STEP 17

Your first note at a glance!

Poznote Synology NAS Set up 12

Enjoy Poznote!

šŸ†˜TROUBLESHOOTING

If you encounter issues by using this container, make sure to check out the Common Docker issuesĀ article.

Note: If you want to run the Poznote container over HTTPS, check How to Run Docker Containers Over HTTPS. In order to make Poznote work via HTTPS/INTERNET, it’s mandatory to activate WebSocket.

Note: Can I run Docker on my Synology NAS?Ā See the supported models.
Note: How to Back Up Docker Containers on your Synology NAS.
Note: Find outĀ how to update the Poznote container with the latest image.
Note: How to Free Disk Space on Your NAS if You Run Docker.
Note: How to Schedule Start & Stop For Docker Containers.
Note: How to Activate Email Notifications.
Note: How to Add Access Control Profile on Your NAS.
Note: How to Change Docker Containers Restart Policy.
Note: How to Use Docker Containers With VPN.
Note: Convert Docker Run Into Docker Compose.
Note: How to Clean Docker.
Note: How to Clean Docker Automatically.
Note: Best Practices When Using Docker and DDNS.
Note: Some Docker Containers Need WebSocket.
Note: Find out the Best NAS Models For Docker.
Note: Activate Gmail SMTP For Docker Containers.

This post was updated on Wednesday / January 21st, 2026 at 2:35 AM

šŸ§” I Need Your Help!