Skip to content

Add NoteDiscovery v0.16.3 - Private Self-Hosted Knowledge Base#40

Open
BookJJun-IJ wants to merge 2 commits intoYundera:mainfrom
BookJJun-IJ:NoteDiscovery
Open

Add NoteDiscovery v0.16.3 - Private Self-Hosted Knowledge Base#40
BookJJun-IJ wants to merge 2 commits intoYundera:mainfrom
BookJJun-IJ:NoteDiscovery

Conversation

@BookJJun-IJ
Copy link
Member

Add NoteDiscovery v0.16.3 - Private Self-Hosted Knowledge Base

Description

NoteDiscovery is a lightweight, privacy-first note-taking app and knowledge base. Notes are stored as plain markdown files — no vendor lock-in, no data sent to external services. An open-source alternative to Obsidian and Notion.

Key Features:

  • Plain markdown file storage with no vendor lock-in
  • Graph view for visualizing connected notes
  • Instant full-text search across all notes
  • LaTeX/MathJax mathematical equation support
  • Mermaid diagram creation
  • HTML export functionality
  • Built-in password protection
  • Dark and light mode

Technical Implementation:

  • Single container architecture: NoteDiscovery (Python)
  • $PCS_DEFAULT_PASSWORD for authentication (no hardcoded credentials)
  • Authentication enabled by default
  • Caddy reverse proxy labels for clean HTTPS URLs
  • Port 80 exposed for clean NSL Router URLs
  • Built-in healthcheck on /health endpoint
  • Multi-language support (English, Korean, Chinese, Spanish, French)

Architecture:

User → Caddy (HTTPS) → NoteDiscovery (port 80) → Markdown files (data volume)

Security Checklist

  • Authentication enabled by default (AUTHENTICATION_ENABLED: true)
  • Default password set via $PCS_DEFAULT_PASSWORD — documented in tips
  • No hardcoded credentials
  • Proper file permissions: user: "0:0" (AppData-only access)
  • Specific version tag: ghcr.io/gamosoft/notediscovery:0.16.3

Functionality Checklist

  • Works immediately after installation
  • Data mapped to /DATA/AppData/$AppID/data/
  • No manual configuration required - authentication pre-configured
  • Data persistence - markdown files persist across reinstalls
  • cpu_shares set: notediscovery: 50 (Standard Application)
  • Resource limits: 512M memory limit
  • Healthcheck with start_period configured
  • Fresh installation tested
  • Uninstall/reinstall tested - data persists

Documentation Checklist

  • Clear description in 5 languages (en_us, ko_kr, zh_cn, fr_fr, es_es)
  • Multi-language taglines
  • Multi-language tips with default password info
  • Icon, screenshots point to BookJJun-IJ/AppStore@create

Testing

  • ✅ Fresh installation - container starts correctly
  • ✅ Healthcheck passes on /health endpoint
  • ✅ Login with $PCS_DEFAULT_PASSWORD working
  • ✅ Note creation with markdown working
  • ✅ Graph view rendering connected notes
  • ✅ Full-text search functional
  • ✅ LaTeX and Mermaid rendering working
  • ✅ Dark/light mode toggle working
  • ✅ Data persistence across uninstall/reinstall
  • ✅ Resource usage within configured limits

Category

Documents

Screenshots

  1. Private markdown knowledge base — your data never leaves your server
  2. Visualize connected notes at a glance with graph view
  3. Instant full-text search with LaTeX and Mermaid diagram support

Links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant