docs: base images support Fedora/RHEL/Arch/Alpine (drop Debian-only restriction) - #313
Conversation
…Debian-only The base-image page stated "E2B currently supports only Debian-based images … Alpine, RedHat-based … not supported." That's no longer true — the orchestrator now identifies the distro from /etc/os-release and provisions Debian/Ubuntu, Fedora + RHEL family (Rocky/Alma via ID_LIKE), Arch, and Alpine (infra #3381, proven on real KVM). Correct the restriction to an accurate supported-set note, and add the new fromFedoraImage/fromAlpineImage/fromArchImage (and Python from_*_image) convenience helpers to the examples (SDK: E2B #1612). Images with no identifiable distro (no /etc/os-release: scratch/distroless/ pure nixos-nix) and minimal images missing required packages (UBI-minimal) are called out as rejected-with-a-clear-error.
PR SummaryLow Risk Overview Predefined-image examples add Reviewed by Cursor Bugbot for commit 5c1bb32. Bugbot is set up for automated code reviews on this repo. Configure here. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit b73ffb9. Configure here.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
tomassrnka
changed the title
The SDK helpers pin fedora:44 and alpine:3.24; fedora:42 is end-of-life.
Add a NixOS base image subsection and reconcile the supported-distros Note to point readers at the official e2bdev/nixos image instead of a raw NixOS image.
Break the dense base-image note into scannable supported/not-supported lists, drop em-dashes, and surface the NixOS guidance as a warning.
2 participants
What
Corrects
docs/template/base-image.mdx. It stated verbatim "E2B currently supports only Debian-based images … Alpine, RedHat-based … not supported" — now false./etc/os-releaseand supports Debian/Ubuntu, Fedora + RHEL family (Rocky/AlmaLinux viaID_LIKE), Arch, Alpine. No-os-releaseimages (scratch/distroless/purenixos/nix) and minimal-repo images (UBI-minimal) are rejected with a clear error.fromFedoraImage/fromAlpineImage/fromArchImage(+ Pythonfrom_*_image) to the convenience-method examples.Merge order — this PR must land after the SDK release
This is the last of three pieces:
from*Imagehelpers these examples call. Merged, release pending (its changeset has not been consumed yet).Hold until the SDK release ships. #1612 is merged but not yet published, so merging this first would document methods users cannot call from a released SDK.
The example versions (
fedora:44,alpine:3.24) match the pinned SDK defaults. E2B #1625 brings the Python defaults in line with JS at those same tags, and they are the tags the orchestrator's distro build tests cover.Note: the same text also exists in the private
e2b-dev/docs-privatemirror — worth syncing there too.🤖 Generated with Claude Code