ObliviOS Developer portal Project site

Home / Decisions / ADR-170

Rename the project from SovereignOS to FreeholdOS across all four repositories, the documents, the Android package identities.

Superseded, recorded 15 October 2026.

Decision
ADR-170
Date
2026-10-15
Status
SupersededSuperseded by ADR-224 (the name only). Accepted (owner, 2026-10-15, after review of the written design). Plan 1 is executed: every name except the application identity is renamed in the repositories, the documents, the build and OTA servers, the workstation and GitHub. The application identity, the live tree, the first renamed image and the device tests are open (plan 2). Decisions 6 and 7 of the design were taken by the owner on 2026-10-15 after R1 to R4 (research): the application id is a clean break to org.freeholdos.*, deleting the Guardian history and AirPods preferences of upgraded devices at the first boot, and the decoy user type value changes, deleting every existing decoy user, which the owner recreates after the flash.
Mentions
ADR-093, ADR-097, ADR-224
Mentioned by
ADR-171, ADR-224, ADR-247

1Decision

Rename the project from SovereignOS to FreeholdOS across all four repositories, the documents, the Android package identities (org.sovereignos.* becomes org.freeholdos.*, including permissions, the decoy user type, resource names, vendor directories and patch names), the build and signing servers, the host aliases and the GitHub repository names, as designed in 2026-10-15-freeholdos-rename-design.md. The mapping is mechanical and case-preserving. The policy of ADR-093 and ADR-097 continues: closed records keep their text.

2Why and evidence

The owner reports that a third party already ships an operating system named SovereignOS for Pixel phones; this was not verified in source. The new name was chosen by the owner against three criteria: no known operating system of that name, the style of SovereignOS (a concept word and OS), and no absolute promise. FreeholdOS showed no operating system, ROM or distribution of that name on GitHub, the Wikipedia lists, XDA, AlternativeTo, DistroWatch or the web, and its domains and package names are free. The same method missed SovereignOS of the third party, trademarks were not searched, and the GitHub organisation FreeholdOS is taken (empty).

3Consequences

Unlike ADR-093, the rename changes Android package identities on devices that hold data (stallion carries personal data). Research tasks R1 to R3 of the design (how the pinned tag treats a renamed system package, a per-component data inventory, the persisted decoy user type) gate the first image; if data cannot be carried the choice returns to the owner and no data is deleted without a yes.

The directory move on the build server and the OTA server needs a window and a compatibility symlink. The hook check-official-build.py, the scripts under tools/build/ and check-required-packages.sh hard-code the old names and move with the directory. The certbot renewal configuration of the OTA server names a directory that no longer exists and its certificate expires on 2026-11-22; the renewal is planned on its own date.

4Review when

R1 to R3 show that data cannot be carried; an operating system or a counsel objection named FreeholdOS appears; the owner changes the name before phase 1 starts; the signing VM or the hypervisor survey finds names the design does not cover.

Read from docs/governance/decision-log.md, entry ADR-170.