NoteDiscovery

Light Markdown notes in plain files, with links, a graph and search

  • ghcr.io/hsinghhira/notediscovery:latest
  • v0.35.0
  • Updated 21 Nov 2026
  • port 6788
  • amd64 · arm64
  • Productivity
  • 2.9k stars

Screenshots

NoteDiscovery screenshot 1: NotesNoteDiscovery screenshot 2: GraphNoteDiscovery screenshot 3: Editor

Open the app

Web app

http://localhost:6788/

API docs

http://localhost:6788/docs

About NoteDiscovery

NoteDiscovery is a fast note app for your own server. Notes are plain Markdown files in folders, so nothing is locked in. Link notes together, see them on a graph, search everything at once, and share a single note by link.

Features

  • Markdown notes with live preview, math and diagrams
  • Links between notes, backlinks and a graph view
  • Instant search across all your notes
  • Folders, tags, templates and drawings
  • Share a note by link, and many themes
  • Plain files you can back up or open in any editor

How to use

  1. Open NoteDiscovery from your dashboard.
  2. Sign in with the password from the app's logs (the box marked CREDENTIALS).
  3. Click New Note and start writing.
  4. Type [[ to link to another note, and open the graph to see how they connect.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6788. The login is on, with a password made on first start, shown in the app's logs in the box marked CREDENTIALS and saved in /DATA/AppData/notediscovery/data/.icestore/password (upstream ships the login off with the password admin). Set AUTHENTICATION_PASSWORD to pick your own. Your notes are plain Markdown files in /DATA/AppData/notediscovery/data. The other settings are in the Variables tab and are added in the app settings. 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.
AUTHENTICATION_PASSWORD—The password to open your notes. Leave it empty and one is made for you: it is shown in the app's logs, in the box marked CREDENTIALS.

Sign-in

VariableDefault valueDescription
AUTHENTICATION_ENABLEDtrueSet to false to turn the login off. Only do this behind another sign-in.
AUTHENTICATION_SECRET_KEY—The key sessions are signed with. It is made on first start and kept in /app/data/.icestore.

Look

VariableDefault valueDescription
APP_NAMENoteDiscoveryThe name shown in the app, on the login page and in the browser tab.
DEFAULT_THEMElightThe theme for new browsers, like light or dark.
AUTOSAVE_DELAY_MS1000How long to wait after typing before saving, in milliseconds.

Sharing

VariableDefault valueDescription
SHARE_PUBLIC_ORIGIN—The address used in share links, like https://notes.example.com. Leave it out to use the address in your browser.
docker-compose.yml
name: notediscovery

services:
  notediscovery:
    image: ghcr.io/hsinghhira/notediscovery:latest
    container_name: notediscovery
    restart: unless-stopped
    stop_grace_period: 20s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - AUTHENTICATION_PASSWORD=
    ports:
      - target: 8000
        published: "6788"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /app/data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/health')"]
      interval: 60s
      timeout: 5s
      retries: 3
      start_period: 30s
    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/notediscovery/icon.png
    x-casaos:
      id: com.icestore.notediscovery
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: AUTHENTICATION_PASSWORD
          description:
            en_US: >-
              The password to open your notes. Leave it empty and one is made
              for you: it is shown in the app's logs, in the box marked
              CREDENTIALS.
      ports:
        - container: "8000"
          description:
            en_US: NoteDiscovery web app and API, published on host as 6788
      volumes:
        - container: /app/data
          description:
            en_US: >-
              Your notes, as plain Markdown files in folders, and the login
              password and key (.icestore). Back it up.

x-casaos:
  id: com.icestore.notediscovery
  architectures:
    - amd64
    - arm64
  main: notediscovery
  author: HSinghHira
  category: Productivity
  developer: gamosoft
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/notediscovery/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/notediscovery/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/notediscovery/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/notediscovery/screenshot-2.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/notediscovery/screenshot-3.png
  title:
    en_US: NoteDiscovery
  tagline:
    en_US: Light Markdown notes in plain files, with links, a graph and search
  description:
    en_US: >-
      NoteDiscovery is a fast note app for your own server. Notes are plain
      Markdown files in folders, so nothing is locked in. Link notes
      together, see them on a graph, search everything at once, and share a
      single note by link.


      **Features**


      - Markdown notes with live preview, math and diagrams

      - Links between notes, backlinks and a graph view

      - Instant search across all your notes

      - Folders, tags, templates and drawings

      - Share a note by link, and many themes

      - Plain files you can back up or open in any editor


      **How to use?**


      1. Open NoteDiscovery from the ZimaOS dashboard.

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

      3. Click New Note and start writing.

      4. Type [[ to link to another note, and open the graph to see how
         they connect.
  tips:
    before_install:
      en_US: >-
        1. Start the installation. It is ready in under a minute.


        2. Open the app's logs. Find the box marked CREDENTIALS. It has the
           password.


        3. Open http://[ZIMAOS-IP-ADDRESS]:6788 and sign in.
  index: /
  port_map: "6788"
  scheme: http
  is_uncontrolled: false
  version: "0.35.0"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6788
      - Built on ghcr.io/gamosoft/notediscovery 0.35.0
      - The login is on, with a password and session key made for each install (upstream ships it off, with the password admin); the password is in the CREDENTIALS box in the logs
  repo: "https://github.com/gamosoft/NoteDiscovery"
  support: "https://github.com/gamosoft/NoteDiscovery/issues"
  docs: "https://github.com/gamosoft/NoteDiscovery/tree/main/documentation"

Install NoteDiscovery

Something not working with NoteDiscovery?

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

More Productivity apps

See all