Self-host Oxynote
v0.9.3Technical wiki with live metrics and review flows
- Stars
- 426
- Port
- 8080 (HTTP web interface and API)
ghcr.io/oxynote/oxynote
What is Oxynote?
Oxynote is a self-hosted workspace for technical documentation that puts live metric charts next to the text explaining them. It lets engineering teams write internal API docs with Stripe-style split views, run Prometheus and SQL queries directly in pages, and route every change through a draft branch with block-level diffs and approvals. Pages support real-time collaborative editing with comments, a page tree with tags and full-text search, and both light and dark themes. The built-in AI assistant (Rubber Duck) can edit pages and run the same queries as metric blocks, with support for Anthropic, OpenAI, Google, OpenRouter, and local models via Ollama. MCP clients like Claude Code and Codex can access the same tools over OAuth. Oxynote runs as a single Docker image (ghcr.io/oxynote/oxynote) that bundles Caddy, the Nuxt/Vue frontend, a Go API server, a Node auth/realtime service (Better Auth + Hocuspocus/Yjs), and an embedded PostgreSQL database. Optional external dependencies include Valkey/Redis for caching, S3-compatible object storage, an SMTP relay, and changedetection.io for URL watching. Authentication supports built-in email/password plus social login via GitHub, Google, or Slack. The project is licensed Apache-2.0 and currently at v0.9.0 (pre-1.0 beta).
Should you self-host Oxynote?
Oxynote scores 49/100 on selfhost.directory (how scoring works) and ranks #22 of 42 in Knowledge Management. It has 426 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v0.9.3, came out on 27 October 2026. New versions land roughly every 2 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is AppFlowy (82/100, 77 896 stars). It scores higher overall, so compare the two before you pick. See Oxynote vs AppFlowy side by side.
Features
- AI assistant (Rubber Duck)
- Comments and threads
- Freshness hooks
- Full-Text Search
- Keyboard Shortcuts
- Live metric charts
- MCP Server
- Page tree with tags
- Real-time collaborative editing
- Review flows with drafts, diffs, and approvals
- Rich content blocks
- Social login (GitHub, Google, Slack)
- Stripe-style split API documentation
- Workspaces with invitations
Oxynote README
FAQ
Why the name Oxynote?
Internally it was first called "breathing docs". Breathing needs oxygen, so "oxy" became the prefix and "note" followed.
Does it replace Grafana?
That is the goal. Today it covers metric charts and dashboard-style grids from Prometheus and SQL with explanations written next to them. Logs and alerting are not there yet but are being worked on.
More in Knowledge Management
PandaWikiOpen-source, self-hosted knowledge base that builds product docs, FAQs and blogs with AI Q&A, AI search and chatbots for DingTalk, Feishu and WeCom.
Pepperminty-WikiSelf-hosted, open-source wiki engine in a single PHP file with flat-file storage, Markdown, full-text search, revision history, file uploads, and dark theme.
Personal External Brain Knowledge GraphSelf-hosted, open-source personal knowledge graph for notes, web pages, PDFs, audio/video with topic-isolated recall and source citations — refuses ungrounded answers.
PetrichorPetrichor is an open-source, self-hosted platform turning Markdown into semantic wikis with agentic RAG for traceable, evidence-backed answers.
PharosSelf-hosted, open-source RAG system with multi-format document ingestion, hybrid retrieval, enterprise ACL, and dual HTTP + MCP exits for team knowledge bases.
PineDocsPineDocs is a self-hosted, open-source file viewer for Markdown, HTML, code, images, PDFs, and media — no database needed. Runs via Docker or PHP with dark mode.
plan42Collavre is a self-hosted, open-source workspace where every block is a document, task, discussion, and AI agent context in one. Built on Rails with MCP.
PlanePlane is a self-hosted open-source project management platform combining work items, cycles, wiki docs, and AI agents as an alternative to Jira, Linear, and ClickUp.- PmWikiPmWiki is a wiki-based content-management system (CMS) for collaborative creation and maintenance of websites. It allows users to create and edit pages using simple markup rules without requiring knowledge of HTML or CSS.
PoznoteA free, open-source, self-hosted notes app offering rich text, Markdown, tasks, boards, graphs, an AI chat, and an MCP server — replacing Notion on your own server.
Project N.O.M.A.D.Open-source, self-hosted offline knowledge and education server: Wikipedia, maps, Khan Academy courses and optional local AI, all managed from one Docker dashboard.
Pydio CellsFuture-proof content collaboration platform
0 comments