doona
doona documentation
Demo
English
doona documentation

doona documentation

For a direct-only first run, follow Quick start.

doona is a static web UI for the native API that the daeuniverse engines share: honk today, dae once it implements the same contract. honk is a Rust transparent-proxy engine for Linux gateways; it serves doona itself at /ui/, or any web server can. doona shows what the engine is doing and manages nodes, groups, routing rules and configuration files.

Choose an edition

Standard edition doona lite
For managing configuration and observing traffic For beginners editing configuration
Traffic pages, configuration forms, source editor and Trace Nodes, subscriptions, groups, routing, DNS and global settings
Install the standard edition Install doona lite
Standard demo lite demo

See Standard edition and doona lite for features and switching.

Try the demo with sample data.

The activity page

Native API status

These pages cover doona v0.1.0-beta.19. doona uses honk's native API from the honk-core builds attached to each release, built from Glassyiris/honk feat/native-api debug tags. HONK-SOURCE.txt identifies the bundled build; see honk version. Upstream daeuniverse/honk main does not provide this API. Keys and defaults may change before upstream honk releases it.

Installation examples use beta.19 asset names and the matching honk tag debug.2026.10.9.native-api.2. The assets are published on the release page.

Pages

For a new gateway, start with Requirements, install honk and an edition, then follow Minimal configuration and Service management. Continue with First sign-in for the standard edition or Connect doona lite.

  1. Start: Standard edition and doona lite, Requirements.
  2. Install and first run: Install on Debian or Ubuntu, Install on Fedora or RHEL, Install on Arch Linux, Install on Gentoo, Install on OpenWrt, Install on other systems, Installation details, Minimal configuration, Service management.
  3. Standard edition: First sign-in, Interface tour, Watching traffic, Routing, nodes and rules, Config and settings, Common tasks, Features.
  4. doona lite: doona lite, Connect doona lite, Common tasks in doona lite.
  5. Reference: Configuration, Troubleshooting, Development.
doona

doona documentation

English
doona documentationFor a direct-only first run, follow Quick start. Quick startStart the standard edition of doona with a direct-only honk configuration, sign in, and verify traffic from the gateway itself. Standard edition and doona liteThe standard edition manages configuration and observes traffic. Requirements Install on Debian or UbuntuInstall doona from the doona-web .deb package and honk-core from the same release on Debian, Ubuntu or another APT-based system. Install on Fedora or RHELInstall doona from its .rpm package and honk-core from the same release on Fedora, RHEL or another DNF-based system. Install on Arch LinuxInstall doona from its .pkg.tar.zst package and honk-core from the same release on Arch Linux or another pacman-based system. Install on GentooInstall doona with Portage from the repository's ebuild in a local ebuild repository, and honk-core from the same release. Install on OpenWrtInstall doona from a release package or archive and honk-core from the same release on OpenWrt 25.12. Install on other systemsInstall doona and honk-core from release archives on an x86_64 or aarch64 Linux system that meets the kernel requirements below. Installation detailsInstall honk, write its configuration, then install doona and start honk. Minimal configurationThis page writes the smallest honk configuration that starts honk and serves doona, then checks it by starting honk by hand. Service managementThis page runs honk as a systemd or OpenWrt procd service: it creates the service once, then lists the commands that start, stop, restart and reload honk and read its log. Route your first connectionContinue from Quick start, with honk running and your administrator signed in. First sign-inThis page opens doona in a browser, creates the administrator account and checks that doona shows the running honk. Interface tourUse the navigation to open a page, the top bar to search or refresh, and the page tabs to change views. Watching trafficUse Activity and System status to read engine health, and Connections, Routing log and DNS to inspect traffic. Routing, nodes and rulesPolicies manages group selection and membership. Config and settingsConfiguration reads, validates and applies honk's configuration files. Common tasksThis page covers the standard edition; for doona lite, see doona lite. FeaturesFor each feature’s prerequisites and disabled-action explanations, see Feature requirements. doona litedoona lite edits honk configuration through a smaller interface for beginners. Connect doona liteConnect doona lite to the honk native API, or open the demo without a backend. Common tasks in doona liteUse doona lite to import resources and edit honk configuration. ConfigurationUse this reference for honk's DAE settings exposed by doona, their defaults, and their application paths. What doona can changedoona changes configuration sources, runtime state, persistent geodata settings, and browser preferences through different controls. Feature requirementsFind your standard-edition feature in the table, then use its section to check prerequisites and enable it. Troubleshooting DevelopmentRead CONTRIBUTING.md before opening a pull request.