Security model / Operator owned
Trust is configured locally.
Rookrunner is designed for an operator-controlled Linux host. The operator owns the worker, Docker engine, state, credentials, network access, and runner image.
Default boundaries
- The worker handles one job at a time and uses Docker containers for jobs.
- Job container networking defaults to
none;bridgeopts into public internet access. - The worker socket is local and mode
0600; its state directory is mode0700. - Fork pull requests are refused by default. PRs that change workflow files are also refused unless an explicit per-poll override is used.
- Secrets, OIDC, passwordless sudo, job privileges, and Docker socket access are opt-in.
Poll trust gates
poll supports push, pull request, schedule, and workflow dispatch events for one owner repository. Forks and untrusted commits are refused by default. The per-invocation --allow-untrusted SHA flag admits one named commit. A PR workflow change can be admitted with --allow-pr-workflow OWNER|MEMBER|COLLABORATOR. These switches are deliberate risk overrides, not trust repairs, and are recorded on the run.
Fork code never receives file secrets or an OIDC token. An admitted same-repository PR may qualify for secrets when the explicit secret allowlist matches, but OIDC token minting refuses any run created with a trust override. Read Secrets and OIDC tokens before changing these settings.
Container privilege
--passwordless-sudo can let code become root inside a job container. --job-privileges adds only CAP_SYS_CHROOT and a restricted seccomp allowance; it does not mean a privileged container. --docker-socket gives job code control of the host Docker engine and should be treated as host-level access. These options are off by default.
Not a hostile-code sandbox
Containers and the default network mode reduce access, but they do not make a shared self-hosted machine safe for arbitrary hostile code. Use dedicated infrastructure, protect service credentials and state, and do not expose local control endpoints to the network. Rookrunner does not claim the security equivalence of hosted runners.