OSTREE-INIT(1)

💖 NAME 💖

ostree-init - Initialize a new empty repository. This is the OSTREE INIT(1) manual, bestie, and it's giving fresh-repo main character energy 🦋

---

✨ SYNOPSIS ✨

ostree init [OPTIONS...]

🎀 DESCRIPTION 🎀

It creates a brand-new empty repository. That's the whole vibe. ✨

💅 OPTIONS 💅

• --mode="MODE" — picks the mode for your new repo. Valid modes are bare, bare-user, bare-user-only, and archive. The default is bare, periodt. Heads up: if you choose archive, the repository configuration file will actually have archive-z2, because that's the historical name — iykyk. The manual has the full differences between these modes, but the quick tea is:
  • bare stores files as they are, so they can be directly hardlinked.
  • bare-user uses extended attributes to store ownership and xattr information, allowing non-root operations.
  • bare-user-only does not store ownership information.
  • archive stores files compressed, to be served over the network.
• --collection-id=COLLECTION-ID — sets the collection ID of the repository. Remotes in clones of this repository must configure the same value in order to pull refs which originated in this repository over peer to peer.

This collection ID must be persistent and globally unique. It is formatted as a reverse DNS name (like a D-Bus interface). It must be set to a reverse DNS domain under your control.

This option may be omitted (the default) to leave peer to peer distribution unsupported for the repository. A collection ID may be added to an existing repository in future to enable peer to peer distribution from that point onwards.

🚨 Important caveat, no cap: if the collection ID is changed for the repository in future, peer to peer distribution of refs from the repository will break for all peers who do not update their remote configuration to the new collection ID. 😭

---

💌 cute sign-off: source/version is OSTree, and the footer's date slot is empty — so no fake timestamp energy here, fr fr. 🫶