What Nether is
Nether is an open-source workspace that combines Obsidian’s local-first, linked notes with Notion’s databases and collaboration. Notes are plain Markdown files you own; the same notes can become databases, wikis and shared projects, without depending on anyone’s cloud.
Principles
Section titled “Principles”When two of these conflict, the higher one wins.
- You own your data. Every note exports as standard Markdown with YAML frontmatter, with its attachments, at any time and with no loss of text. Databases export to CSV and Markdown.
- Local first, server optional. The desktop app works fully offline with no account. A server adds sync, collaboration, sharing and publishing, and is never needed for writing.
- Self-hosting comes first. One
docker compose upstarts a working server, and any hosted service runs the same code. - Fast on large workspaces. Opening the app, switching notes and searching stay fast at 50,000 notes.
- Structure is optional. A note starts as plain writing; properties, database views and templates come when you want them.
- Extensible. Nether’s own features use the same plugin API as everyone else’s, wherever practical.
- Private by default. No telemetry unless you opt in, and end-to-end encryption for sync.
- Bring your own AI. Any OpenAI-compatible endpoint, Anthropic, or a local model, configured by you; Nether depends on no AI vendor.
Everything is free
Section titled “Everything is free”Nether is licensed under the AGPL-3.0-or-later. The desktop app, the self-hosted server and every feature, enterprise features such as single sign-on and audit logs included, are free. There are no paid editions, no license keys and no seat limits, and nothing phones home.
Where it stands
Section titled “Where it stands”Five of Nether’s six phases are done. The desktop app keeps a vault of
Markdown notes with the block editor, links and backlinks, tags, search,
templates and export, and turns notes into databases with six views,
relations, rollups and formulas, with the graph, the canvas, themes, and
importers from Obsidian, Notion, Logseq, HTML and CSV. A server you
start with one docker compose up syncs it, with
end-to-end encryption, spaces and sharing, co-editing, comments and
mentions, history and backups, and serves the web app.
Version 0.2.0, with the phone apps, is ready to install. The fifth phase, the platform, is done: the plugin API is done, and Nether’s own diagrams, panels, canvas, graph and database layouts are built-in plugins on it. Plugins from a vault run in a sandbox, with only what each device approved for them, and plugins and themes install from Nether’s directory. The server’s REST API reads and writes notes, databases and search for scripts, with personal access tokens, and its webhooks tell other services when notes change; the app makes both. The web clipper saves pages and selections from Chrome and Firefox as Markdown. PDFs open in a view of their own and in the notes that embed them, their words or areas highlighted and commented on, each highlight Markdown that Obsidian reads. Writing assist rewrites, fixes, summarizes, translates or continues what you select, with an AI provider you bring, in the desktop app and in the web app through its server, and search by meaning finds notes by what they are about, and asking your notes answers from them, each citation a link to its passage. Building with AI makes a database, a template or a project plan from a description, previewed before it is made. Share links open a page to anyone with one, with no account, to read, to comment on or to edit. Buttons in a note, written as Obsidian’s Meta Bind writes them, run commands, make notes from templates and set properties, and a database’s triggers set a row’s properties when one becomes a value. A page or a folder publishes as a site the server draws for anyone, on a domain of your own if you like, its links only between its own pages. The roadmap lists what each phase delivers.
The sixth phase, enterprise, mobile and scale, is under way. Its features are free and off until an instance admin turns them on in the admin console, which lists every workspace and sets how long sessions last. AI keeps to the endpoints an organization approves. Single sign-on goes through SAML and OpenID Connect providers, and can be required. Data policies set public sharing, export, retention and legal hold. Provisioning makes, changes and deactivates accounts and groups from Okta or Entra ID by SCIM, or by reading Active Directory or OpenLDAP. Audit logs record every sign-in, permission change, share, export and deletion, chained so a change shows, and send them to a SIEM by syslog or a webhook. And high availability runs several server nodes, upgraded one at a time, on Kubernetes with the Helm chart. The Android and iOS apps keep vaults on the phone, sync while they are open, and capture from their icon’s shortcuts and the share sheet.
The full requirements, the architecture and the decision records live in the repository.