KyNotes

End-to-end encrypted notes with text, handwriting and team notebooks.

  • ghcr.io/busnes-app/kynotes-server:0.6.0
  • v0.6.0
  • Updated 9 Nov 2026
  • port 6696
  • amd64
  • Productivity
  • 0 stars

Screenshots

KyNotes screenshot 1: NotebooksKyNotes screenshot 2: CanvasKyNotes screenshot 3: Sub-pages

Open the app

Web App

http://localhost:6696/

About KyNotes

KyNotes is a browser notebook for encrypted text, handwriting, attachments and tasks, with shared team notebooks. Notes are decrypted in your browser, so the server (and its administrator) never reads them. Part of the Busnes Ky Suite; it works on its own or with KyIdentity sign-in.

Features

  • Notebooks, sections and pages with text, ink canvases and attachments
  • Tasks and a work queue across your notebooks
  • Team notebooks with shared keys
  • Separate administrator and everyday accounts; optional KyIdentity sign-in
  • Sealed backups to KyRecovery, and an MCP server for AI agents

How to use

  1. Put KyNotes behind your reverse proxy with an https domain.
  2. Copy the setup token from the app's logs.
  3. Open your https address, enter the token and make the administrator and your everyday account.
  4. Sign in with your everyday account and start writing.

Before you install

KyNotes needs https. Browsers only allow the encryption it uses on an https address, or on the box itself at http://localhost:6696. Set up a reverse proxy with your own domain, like https://notes.example.com, pointed at http://[ZIMAOS-IP-ADDRESS]:6696, and set TRUSTED_PROXY_CIDRS to the proxy's address.

On the first start KyNotes prints a one-time setup token in its logs (the setup_token line), on every start until setup is done. The setup page asks for it and makes an administrator account (manages KyNotes, can't open notes) and an everyday account (writes notes). Keep the recovery codes it shows. It starts in a few seconds. More settings (backups, the attachment mirror) are in the Variables tab; add them in the app settings. The image is built for amd64 only.

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. Leave it unless you need another.
PORT8080The port KyNotes listens on inside the container. Leave it as 8080.
KYNOTES_DATA_DIR/dataWhere KyNotes keeps its data inside the container. Leave it as /data.

Reverse proxy

VariableDefault valueDescription
TRUSTED_PROXY_CIDRS—The address of your reverse proxy as KyNotes sees it, like 172.17.0.1/32, so it believes the visitor's IP from the proxy. Only your proxy; never a whole network.

First accounts

VariableDefault valueDescription
BOOTSTRAP_ADMIN_USER—Make the administrator account on first start instead of on the setup page. Use it with BOOTSTRAP_ADMIN_PASS.
BOOTSTRAP_ADMIN_PASS—The administrator's first password. It must be changed at the first sign-in.
BOOTSTRAP_EVERYDAY_USER—Make an everyday (note-writing) account on first start, with a different name from the administrator.
BOOTSTRAP_EVERYDAY_PASS—The everyday account's first password.

Backups

VariableDefault valueDescription
KYNOTES_BACKUP_DEPOSIT_INTERVAL24hHow often KyNotes sends a sealed backup to a paired KyRecovery. 0 turns it off; the admin page setting wins.
KYNOTES_BACKUP_DIR—A folder inside the container for local sealed backups, like /data/backups.
KYNOTES_BACKUP_KEEP7How many local backups to keep.
KYNOTES_BACKUP_ALLOW_PRIVATE_RECOVERYfalseSet to true for a KyRecovery on your home network (it still needs https).

Attachment mirror

VariableDefault valueDescription
KYNOTES_BLOB_TARGET—Where to mirror the encrypted attachments (S3, SFTP, SMB or a folder). Backups don't include them, so set this for a complete backup. See upstream's deployment guide for the format.
KYNOTES_BLOB_TARGET_ACCESS_KEY—The user name or S3 access key for the mirror.
KYNOTES_BLOB_TARGET_SECRET—The password or S3 secret key for the mirror.
KYNOTES_BLOB_TARGET_S3_ENDPOINT—The S3 endpoint, for an S3 mirror that isn't AWS.
KYNOTES_BLOB_TARGET_S3_REGION—The S3 region of the mirror.
docker-compose.yml
name: kynotes

services:
  kynotes:
    image: ghcr.io/busnes-app/kynotes-server:0.6.0
    container_name: kynotes
    restart: unless-stopped
    stop_grace_period: 60s
    network_mode: bridge
    user: "0:0"
    environment:
      - TZ=$TZ
      - PORT=8080
      - KYNOTES_DATA_DIR=/data
    ports:
      - target: 8080
        published: "6696"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "/kynotes-server", "healthcheck"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 1024M
        reservations:
          cpus: "0.00"
          memory: 64M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/icon.png
    x-casaos:
      id: com.icestore.kynotes
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: PORT
          description:
            en_US: >-
              The port KyNotes listens on inside the container. Leave it as
              8080.
        - container: KYNOTES_DATA_DIR
          description:
            en_US: >-
              Where KyNotes keeps its data inside the container. Leave it as
              /data.
      ports:
        - container: "8080"
          description:
            en_US: KyNotes web app and API, published on host as 6696
      volumes:
        - container: /data
          description:
            en_US: >-
              The database, the encrypted notes and attachments, and the
              server's keys. Back up the whole folder; KyNotes can also make
              sealed backups to KyRecovery.

x-casaos:
  id: com.icestore.kynotes
  architectures:
    - amd64
  main: kynotes
  author: HSinghHira
  category: Productivity
  developer: Busnes-app
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/screenshot-2.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kynotes/screenshot-3.jpg
  title:
    en_US: KyNotes
  tagline:
    en_US: End-to-end encrypted notes with text, handwriting and team notebooks.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/kynotes/](https://icestore.hsinghhira.me/app/kynotes/) for full details


      KyNotes is a browser notebook for encrypted text, handwriting,
      attachments and tasks, with shared team notebooks. Notes are decrypted
      in your browser, so the server (and its administrator) never reads
      them. Part of the Busnes Ky Suite; it works on its own or with
      KyIdentity sign-in.


      **Features**


      - Notebooks, sections and pages with text, ink canvases and attachments

      - Tasks and a work queue across your notebooks

      - Team notebooks with shared keys

      - Separate administrator and everyday accounts; optional KyIdentity
        sign-in

      - Sealed backups to KyRecovery, and an MCP server for AI agents


      **How to use?**


      1. Put KyNotes behind your reverse proxy with an https domain.


      2. Copy the setup token from the app's logs.


      3. Open your https address, enter the token and make the
         administrator and your everyday account.


      4. Sign in with your everyday account and start writing.
  tips:
    before_install:
      en_US: >-
        1. KyNotes needs https. Your browser only does the encryption on an
           https address (or on the box itself, at http://localhost:6696).
           Set up a reverse proxy (like Nginx Proxy Manager or a Cloudflare
           tunnel) with your own domain, like https://notes.example.com,
           pointed at http://[ZIMAOS-IP-ADDRESS]:6696.


        2. More settings, like your proxy's address and backups, are listed
           on the KyNotes page at https://icestore.hsinghhira.me/app/kynotes/
           (Variables tab). You can add them now or later in the app
           settings.


        3. Start the installation. It is ready in a few seconds.


        4. Open the app's logs and copy the setup token (the line with
           setup_token). It is printed on every start until setup is done.


        5. Open your https address, paste the token and make two accounts:
           an administrator (manages KyNotes) and an everyday account (writes
           notes).


        6. Write down the recovery codes it shows you. They are the only way
           back in if you forget a password.
  index: /
  port_map: "6696"
  scheme: http
  is_uncontrolled: false
  version: "0.6.0"
  update_at: "2026-11-09"
  release_notes:
    en_US: |-
      - First IceStore version: ghcr.io/busnes-app/kynotes-server 0.6.0
      - Port 6696; the data folder is /DATA/AppData/kynotes/data. Runs as root so it can write to that folder.
  repo: "https://github.com/Busnes-app/KyNotes-server"
  support: "https://github.com/Busnes-app/KyNotes-server/issues"
  docs: "https://github.com/Busnes-app/KyNotes-server/blob/master/INSTALL.md"

Install KyNotes

Something not working with KyNotes?

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

More Productivity apps

See all