daemonarchy README

README проекта с github.com/jordanhubbard/daemonarchy. Одним файлом markdown: README.md.

Daemonarchy

The Daemonarchy desktop: fastfetch, btop, boot environments and home snapshots, with the System > FreeBSD menu open

Daemonarchy is the Omarchy desktop on FreeBSD: DHH's opinionated Hyprland desktop, ported to FreeBSD and installed the way the Omarchy ISO installs it on Arch. The name is a homage: Omarchy's -archy, ruled by the BSD daemon.

You write an image to a USB stick, boot it, answer the questions Omarchy's own installer asks (keyboard, account, hostname, time zone) plus the few that are FreeBSD's own (network, disk), and once the packages have downloaded you are looking at a tiled Wayland desktop with a real FreeBSD underneath it: ZFS, boot environments, jails, bhyve, DTrace, pkg. Daemonarchy is not affiliated with Omarchy; the Omarchy software itself comes, unchanged apart from FreeBSD compatibility, from the x11-wm/omarchy port.

Each release is built from a FreeBSD 16.0-CURRENT snapshot. CURRENT moves daily, so an image is tied to the snapshot it was built from.

Which page do I need?

I want to... Read
Install it and use it This page, then the getting-started guide, which walks through the first hour on the desktop
Know what is the same as FreeBSD and what is different Is it still FreeBSD? below
Change it, build an image, build one port, build FreeBSD "the Daemonarchy way", or cut a release HACKING.md
Know what the project is aiming at PROJECT.md, the active work queue and the architecture
Know what changed in each release CHANGELOG.md

Download

The latest stable release is Daemonarchy 1.5.1 (x86-64, BIOS or UEFI, and a community-validation arm64 image), published November 7, 2026, on FreeBSD 16.0-CURRENT, OSVERSION 1600029. Version 1.2.0 was not published; 1.3.1 followed 1.1.1, 1.4.0 followed 1.3.1, 1.4.1 followed 1.4.0, 1.5.0 followed 1.4.1 and 1.5.1 follows 1.5.0.

From download to desktop

You need a 64-bit x86 PC (UEFI or legacy BIOS), a USB stick of 4 GB or more (the image is 3.5 GB once decompressed, and writing it erases the stick), a disk or free region of 40 GB or more, and a network connection during the install, because the desktop's roughly 1,200 packages are downloaded then rather than carried on the stick. The getting-started guide has the long version with pictures; this is the short one.

  1. Check the download (optional, quick). Put the .iso.xz and its .sha256 in one folder and run sha256sum -c daemonarchy-*.iso.xz.sha256 on Linux, shasum -a 256 -c daemonarchy-*.iso.xz.sha256 on macOS, or Get-FileHash in PowerShell and compare by eye. The checksum covers the compressed file you downloaded. If it says OK, the bytes are the ones in the release.
  2. Write it to the stick. The image is copied byte for byte, so dragging the file onto the stick does nothing useful. balenaEtcher flashes the .iso.xz directly. With dd, find the stick first (lsblk on Linux, diskutil list on macOS) and be sure of the device name, because dd overwrites whatever you point it at: xz -dc daemonarchy-1.5.1-amd64.iso.xz | sudo dd of=/dev/sdX bs=1M status=progress conv=fsync on Linux (on macOS use bs=1m and the /dev/rdiskN name that diskutil list shows).
  3. Boot from it. Press your machine's boot-menu key at power-on (often F12, F11, F10 or Esc; hold Option on a Mac) and pick the stick. Turn Secure Boot off, or enroll the project's certificate to keep it on; factory keys alone reject the project's loader. The x86-64 image shows a short FreeBSD loader menu: press T to try the desktop live from the stick without touching any disk, or let the countdown run to start the installer.
  4. Answer the questions. Keyboard, your name and password, a computer name, a time zone; then the network (a plugged-in cable is usually already up; otherwise choose Join Wi-Fi) and the storage choice. Nothing is written to a disk until you confirm the summary. Whole-disk mode erases the selected disk; partition mode replaces only the GPT partition you select, and free-space mode uses existing free space. The installer does not shrink another system's filesystems, so make room from that system first.
  5. Wait for the success screen. The installer lays out an EFI partition, swap and a ZFS pool (encrypted if you asked), extracts the base system, then installs the desktop with pkg. While it works you can play one of the four arcade games from its Extensions menu. Do not restart until it says it finished: an unexpected reboot is not a completion signal, and if something stops, the rescue menu keeps the log.
  6. Log in. Type your password at the login screen (an encrypted install logs straight in after you unlock the disk at boot). The first login takes a few seconds longer while your desktop is set up. Super (the Windows or Command key) plus Space opens the menu; Super + K lists every shortcut.

The installer can also run without a keyboard from an answers file on a second drive; see the installer reference.

The arm64 image is for adventurous people

The arm64 image is a community-validation image: it was verified to boot and install in a QEMU virtual machine and nothing more. No physical arm64 machine is known to work; the NVIDIA RTX Spark laptop boots its kernel but does not reach a desktop, and support for it is deferred. There is no live desktop, no Secure Boot bundle and no Apple silicon install target. There is one known issue: in QEMU with the default virtio-net network card the install stalls during the package fetch, because the guest stops servicing receive on vtnet0. Start QEMU with -device e1000e until this is fixed; with that card the install takes about 20 minutes and boots under UEFI. If you try it, please open an issue with the machine, the image checksum and what happened, whether it worked or not. The full record is in aarch64.

Is it still FreeBSD?

Yes. If you know FreeBSD you already know most of this system, and if you do not, everything you learn about it from the FreeBSD Handbook applies. This section is the map of where Daemonarchy stops being stock FreeBSD.

What is the same

What is different

What FreeBSD adds

Daemonarchy is the Omarchy desktop with FreeBSD underneath, and it puts FreeBSD's strengths in the Omarchy menu under System > FreeBSD:

Hourly snapshots of a home directory in Files, a live DTrace view of system calls, the ZFS pool, and the sound panel

Omarchy's panels work on FreeBSD too. Wi-Fi runs through FreeBSD's wpa_supplicant, sound through PipeWire, and Bluetooth keyboards and mice through FreeBSD's own Bluetooth stack:

The network panel: Ethernet status, DNS, and nearby Wi-Fi networks (names blurred)

Install software from FreeBSD's package collection through OctoPkg (Install > Packages) or pkg. Chromium is installed by default. Linux-only applications and automatic agent downloads are withheld until their exact versions pass native Linuxulator qualification; see the application policy.

Do I need Literate AI?

No. Literate AI (litai) is a separate project, a release-engineering tool the maintainers use to check Daemonarchy's design contracts and to record evidence about what was built and tested. It is not on the image, not in the package feeds, and nothing you do as a user (installing, updating, running the desktop, using pkg) calls it. Developers can build, test and release Daemonarchy without it too, with less checking; HACKING.md says what it does, where to install it and what is rough about it today.

What the image contains

Other desktop dependencies are downloaded during installation. Compatible official packages come from pkg.FreeBSD.org; the release's versioned feed also supplies ordinary dependencies rebuilt for its newer ports/base selection. Network access is required. Keeping those downloads off the ISO keeps each release asset below GitHub's 2 GiB limit; a complete offline desktop payload would exceed that budget.

Updates

The upgrade model, stated plainly: what pkg upgrade does and does not do, and when an ISO is still needed. Developers who want to publish their own installer and feeds: Forking Daemonarchy.

Application packages update with pkg upgrade (which Omarchy's update runs). This does not update the FreeBSD base/kernel or make kernel modules compatible with another snapshot. FreeBSD's packages come from pkg.FreeBSD.org. Daemonarchy's own packages (the Omarchy ports and the patched Quickshell) come from a signed repository published as the assets of the packages-16-amd64 release. The installer adds its key as /usr/local/etc/pkg/keys/daemonarchy.pub, so fixes reach you without a new ISO. The image's own packages stay on the disk as a fallback repository, Daemonarchy-ISO, since the GPU and Wi-Fi modules built for its kernel are only there.

A system installed from an image dated 2026-10-02 or earlier has only the on-disk repository. To move it to the online one, run as root:

mkdir -p /usr/local/etc/pkg/keys
fetch -o /usr/local/etc/pkg/keys/daemonarchy.pub https://raw.githubusercontent.com/jordanhubbard/daemonarchy/main/overlay/usr/local/share/daemonarchy-installer/daemonarchy.pub
cat >/usr/local/etc/pkg/repos/Daemonarchy.conf <<'EOF'
Daemonarchy: {
  url: "https://github.com/jordanhubbard/daemonarchy/releases/download/packages-16-amd64",
  signature_type: "pubkey",
  pubkey: "/usr/local/etc/pkg/keys/daemonarchy.pub",
  priority: 10,
  enabled: yes
}
Daemonarchy-ISO: {
  url: "file:///var/db/daemonarchy/repo",
  signature_type: "none",
  priority: 5,
  enabled: yes
}
EOF
pkg upgrade

1.5.0 release

1.5.0 is the current stable release. Its notes and the plan say what was done and what was not. 1.5.0 was re-scoped on 2026-11-03 to evidenced work; the framework-executed build-speed goals (BUILD-001, COMP-001, PERF-001, PERF-002, DEV-001 and the native halves of ADOPT-002, SRC-001 and RELEASE-001) moved to 1.5.1. What changed since 1.4.1:

Earlier releases

1.4.1 was the stable release from October 31, 2026 until 1.5.0. Its base was source 303b364 with ports at dd277aff; its notes cover a parallel package fetch from signed Daemonarchy feeds, an install trace, an installer built on a visual SDK with four arcade games as extensions, cudalab as a virtual app, remote debugger leases and a watchdog, and an arm64 image for community validation. 1.4.0 was the stable release from October 29, 2026 until 1.4.1. Its base was source 06e5befc with ports at b7857842. 1.3.1 was the stable release from October 25, 2026 until 1.4.0. Its base was source d63d77f4 with ports at b7857842.

Moving an older installation to the 1.5.0 application feed requires a coordinated base, kernel and driver upgrade; changing the package URL alone is insufficient. Physical GPU, firmware, radio and retained-OS qualification remains explicitly recorded rather than inferred from VM tests.

Hacking on it

If you want to change the installer, fix a port, build FreeBSD from source "the Daemonarchy way", build your own image or test one, start with HACKING.md. It begins with a side-by-side of what you would type on a plain FreeBSD machine (make buildworld installworld in /usr/src, make all install in /usr/ports/<category>/<port>) and what you type for Daemonarchy, then covers the machines and tools you need, the repositories to check out, the build and test loops, and releasing. On a running Daemonarchy desktop, System > FreeBSD > Hack on Daemonarchy fetches the sources for you.

Source

Daemonarchy is built from these repositories:

Roadmap

1.5.0 is available with documented qualification gaps; 1.5.1 is planned. See the roadmap for remaining graphics, Bluetooth, enterprise Wi-Fi, installation and boot support, upstream ports work, and the checks required before release. The partition preview guide covers installing into an existing OS/data partition or creating a new one in free space.

The installer

The installer's screens, its unattended mode, the optional /usr/ports and /usr/src checkouts and the NVIDIA CUDA offer are described in the installer reference. The step-by-step first install is in the getting-started guide; the log, retained evidence and rescue menu are in the rescue console guide.

Release Engineers

Historical limits of 1.0.1

Names and marks

Daemonarchy is a union of two projects and claims to be neither. Omarchy is the desktop and FreeBSD is the operating system underneath; both are credited by name wherever the system describes what it is (the About screen reads "Omarchy on FreeBSD "). Daemonarchy's own identity — the wordmark, the horned "A", the wallpaper, and the login theme's logo — is original artwork that lives in the x11-wm/daemonarchy port, apart from Omarchy's files, which are installed as Omarchy ships them. No FreeBSD or Arch Linux logo is used.

Daemonarchy is not affiliated with or endorsed by Omarchy, the FreeBSD Project, or The FreeBSD Foundation. FreeBSD is a registered trademark of The FreeBSD Foundation. Omarchy is used under the MIT license.

License

Daemonarchy is licensed as described in LICENSE; licenses/README.md lists which components are under which license.

daemonarchy (jordanhubbard/daemonarchy)

Ищем в базе…

Что это?Daemonarchy — это загрузочный установочный образ FreeBSD, который приносит на FreeBSD рабочий стол Omarchy (авторская настройка Hyprland от DHH), а также подписанный репозиторий пакетов для него.
Это Linux-дистрибутив или программа, которую я ставлю на уже установленную систему?Это самостоятельный загрузочный ISO-образ FreeBSD: вы загружаетесь с USB-флешки, установщик размечает диск и ставит FreeBSD вместе с рабочим столом Omarchy/Hyprland как полноценную ОС, а не как приложение поверх существующей системы.
Как его запустить?Скачайте последний релизный ISO (например, daemonarchy-1.3.1-amd64.iso), запишите его на USB-флешку командой 'dd if=daemonarchy-1.3.1-amd64.iso of=/dev/ bs=1m' (на Linux — bs=1M), загрузитесь с отключённым Secure Boot (или добавьте сертификат подписи) и следуйте установщику с экраном приветствия.
Нужен ли интернет для установки?Да, установщику нужно сетевое подключение, так как многие пакеты рабочего стола загружаются во время установки, а не поставляются на ISO.
Гарантированно ли этот образ загрузится на любом компьютере?Нет, поддержка оборудования отслеживается для каждого устройства: MacBookPro16,1 прошёл проверки, но MSI Raider 18 HX всё ещё перезагружается на раннем этапе запуска ядра, а каждый релиз привязан к конкретному снимку FreeBSD CURRENT, из которого он собран.
Для какой архитектуры процессора и на какой базе ОС это сделано?Образ рассчитан на компьютеры с архитектурой x86-64 (BIOS или UEFI) и работает на базе FreeBSD 16.0-CURRENT; это не дистрибутив Linux, хотя на нём работает рабочий стол Omarchy на Hyprland.
Что добавляет FreeBSD, чего нет в Omarchy на базе Arch?Загрузочные окружения ZFS с откатом, ежечасные и ежедневные снимки домашних каталогов, лёгкие изолированные окружения FreeBSD (jails), виртуальные машины bhyve для Linux, Windows и BSD, а также DTrace для отслеживания работы системы в реальном времени. Всё это доступно в меню Omarchy в разделе System > FreeBSD.
Можно ли установить без клавиатуры, в автоматическом режиме?Да: если установщик находит второй диск с меткой CIDATA, в котором есть файл daemonarchy-install.conf, он сам отвечает на вопросы настройки и выключает компьютер по завершении.
Почему это называется Daemonarchy?Название — игра слов: сочетание талисмана FreeBSD (демона) и суффикса '-archy' из Omarchy, ведь здесь Omarchy «правит» не Arch Linux, а BSD-демон.
Как работают обновления приложений и системы после установки?Обновления пакетов приложений выполняются командой 'pkg upgrade' (запускается из процесса обновления Omarchy) из подписанного репозитория пакетов Daemonarchy и из репозитория FreeBSD pkg.FreeBSD.org. Но это не обновляет базу FreeBSD и ядро — для этого нужно отдельное согласованное обновление.
Какие есть похожие проекты?Stela, Snapintosh, redox, vinix, LiberNT, moxnox, mu300-linux, apple_watch_connector
Автор
jordanhubbard
Размер
10.2 MB
Звёзды
257
Возраст
1 мес
Коммиты · 90 дней