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 安装镜像,将 Omarchy 桌面环境(DHH 设计的、有明确主张的 Hyprland 配置)带到 FreeBSD 上,并附带一个经过签名的配套软件包仓库。
这是 Linux 发行版,还是我要装到现有系统上的应用程序?它是一个独立的可启动 FreeBSD ISO 镜像:你从 U 盘启动安装程序,它会对磁盘分区,然后将 FreeBSD 和 Omarchy/Hyprland 桌面作为一个完整的操作系统安装上去,而不是叠加在现有系统上的应用程序。
我怎么让它运行起来?从 GitHub 下载最新版本的 ISO 文件(例如 daemonarchy-1.3.1-amd64.iso),用 'dd if=daemonarchy-1.3.1-amd64.iso of=/dev/ bs=1m' 写入 U 盘(在 Linux 上使用 bs=1M),在关闭安全启动(Secure Boot)的情况下启动(或注册签名证书),然后按照欢迎界面的提示完成安装。
安装时需要联网吗?需要。安装程序必须联网,因为许多桌面软件包是在安装过程中下载的,而不是直接包含在 ISO 镜像里。
所有机器都保证能启动它吗?不能。硬件支持是按设备单独记录的:MacBookPro16,1 通过了检测,但 MSI Raider 18 HX 在内核早期启动阶段仍会重置;此外,每个版本都与其所基于的特定 FreeBSD CURRENT 快照绑定。
它面向哪种 CPU 架构和操作系统基础?它面向 x86-64 架构(支持 BIOS 或 UEFI)的机器,基于 FreeBSD 16.0-CURRENT 构建;尽管运行的是 Omarchy Hyprland 桌面,它并不是 Linux 发行版。
与基于 Arch 的 Omarchy 相比,FreeBSD 增加了哪些功能?ZFS 启动环境(支持回滚)、每小时/每天的用户主目录快照、轻量级 FreeBSD jail、用于运行 Linux/Windows/BSD 的 bhyve 虚拟机,以及用于实时系统跟踪的 DTrace;这些功能都可以在 Omarchy 菜单的“System > FreeBSD”中找到。
可以不用键盘,无人值守地安装吗?可以。如果安装程序找到一个标签为 CIDATA 的第二块硬盘,且其中包含 daemonarchy-install.conf 文件,它就会自动回答安装设置中的问题,并在完成后关机。
为什么叫 Daemonarchy?这个名字是一个双关语,结合了 FreeBSD 的守护神(daemon)吉祥物与 Omarchy 的“-archy”后缀。Omarchy 在这里由 BSD 守护神而不是 Arch Linux“统治”。
安装后,应用程序和系统如何更新?应用软件包通过 'pkg upgrade' 更新(由 Omarchy 的更新流程触发),来源是经过签名的 Daemonarchy 软件包仓库以及 FreeBSD 自身的 pkg.FreeBSD.org。但这不会更新底层的 FreeBSD 基础系统或内核,后者需要单独协调升级。
大小
10.2 MB
星标
257
时长
1个月
提交 · 90 天