This repository is under migration review and is not release-ready. Do not use an unreviewed worktree build in production.
- Answers and downloaded deltas may contain environment topology. Store them with least privilege and never commit live data.
- Keep
PLATFORM_ACCESS_KEYandPLATFORM_SECRET_KEYoutside source control and logs. The upgrade-onlyCATTLE_ACCESS_KEYandCATTLE_SECRET_KEYaliases require the same handling. - Platform URLs are validated before HTTP or WebSocket use. Redirects may not change the scheme, host, or effective port, and Basic Authentication is never forwarded to another origin.
- Additional metadata regions are denied by default. List each reviewed canonical origin in
PLATFORM_ALLOWED_ORIGINS; never use this setting as an unrestricted wildcard. - A downloaded snapshot is persisted and acknowledged only after validation, generation, source reconciliation, and active-state checks succeed.
- Keep the reload listener bound to loopback unless an authenticated local proxy is explicitly designed and tested.
- Enable
--xffonly behind a trusted proxy that replaces, rather than appends untrusted, forwarding headers. - Error handling intentionally reports status codes without echoing platform response bodies.
- The published image defaults to UID/GID
10001. GrantNET_ADMINand a root startup user only to the managed system deployment that must configure the link-local metadata address; the startup wrapper drops privileges before launching the service. - The Windows Server 2022 variant requires
ContainerAdministratorbecause link-local IP assignment is a privileged Windows networking operation. Do not add host filesystem, named-pipe, or Docker daemon mounts to that service.
Report suspected vulnerabilities through the repository's private security advisory channel. Do not include live credentials, private registry addresses, or production metadata in an issue.