Prepare a host
This procedure starts from an authorized checkout on a host that has been declared in the namespace assets. Use the Ubuntu 26.04 or Kali bootstrap in the repository for a fresh native host; the steps below explain the common boundary.
- Confirm the host record. Run
hostnameand verify that the exact value appears in the authoritativeassets.<namespace>document. A missing host is a successful no-op during deployment. - Prepare the protected bootstrap inputs. Set
configr_op_service_account_nameandconfigr_op_service_account_keyin the environment or a repo-root.envwith mode0600. The key is a directops_service-account token. Never put it in a command argument or documentation example. - Check account scope. The account must authenticate as the named active service account and expose exactly one namespace vault with read access. Configuration repair and push also need write access.
- Use the matching bootstrap for a fresh host. On Ubuntu 26.04 run
./bootstrap-ubuntu-26.04.sh; on Kali run./bootstrap-kali.sh. Existing checkouts can go directly to the deployment procedure. - Validate before mutation. Run
./enclavr config validateand./enclavr host planfrom the checkout.
See how a namespace works for the source-of-truth model. Keep protected inputs on the host; this public site does not accept or store them.