Skip to content

docs(readme): Codex's sandbox on Ubuntu 23.10+ needs bubblewrap and an AppArmor profile - #25

Merged
sanctrl merged 1 commit into
mainfrom
docs/ubuntu-sandbox
Nov 20, 2026
Merged

sanctrl merged 1 commit into
mainfrom
docs/ubuntu-sandbox

Conversation

@sanctrl

@sanctrl sanctrl commented Nov 20, 2026

Copy link
Copy Markdown
Contributor

What changes

The README's Quick start says what Ubuntu 23.10 and newer (24.04 included) need before Codex can run sandboxed: bubblewrap and AppArmor's bwrap-userns-restrict profile, with Codex's own fix (link to its sandboxing page). Without them every sandboxed codex exec fails, the user's own included, and so do the runs this integration starts; the README now names both error lines so a user can match theirs.

Docs only. No code change.

Verification

  • Tests: n/a: README only.
  • Review: not needed: a docs note quoting Codex's documented fix.
  • Live check: on a fresh Ubuntu 24.04 box, codex exec and this integration's runs failed with bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted until these steps; after them codex sandbox linux -- uname -sr printed the kernel and the runs went through.

Risk and rollback

None for users. Rollback: revert.

@sanctrl
sanctrl merged commit 4dda4f5 into main Nov 20, 2026
5 checks passed
@sanctrl
sanctrl deleted the docs/ubuntu-sandbox branch November 20, 2026 10:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant