Skip to content

docs: clarify Debian/Ubuntu requirement for custom template builds (fixes #1280)#2488

Open
AdaAibaby wants to merge 2 commits intoe2b-dev:mainfrom
AdaAibaby:docs/debian-only-template-note
Open

docs: clarify Debian/Ubuntu requirement for custom template builds (fixes #1280)#2488
AdaAibaby wants to merge 2 commits intoe2b-dev:mainfrom
AdaAibaby:docs/debian-only-template-note

Conversation

@AdaAibaby
Copy link
Copy Markdown

📝 Description

This PR addresses Issue #1280 and recent discussions in the E2B Discord community regarding build failures with non-Debian base images.

Currently, the provisioning scripts rely on apt and Debian-specific filesystem layouts. Users attempting to use images like Alpine or CentOS often face cryptic build errors. This documentation update explicitly states the requirement for Debian/Ubuntu-based images to prevent this confusion.

🛠️ Changes

  • Added a Limitations section to the documentation.
  • Explicitly noted that custom template builds require Debian/Ubuntu-based images with apt.
  • Clarified that non-Debian images (Alpine, CentOS/RHEL, etc.) are currently unsupported.

🔗 Context

💡 Motivation

To save users time debugging build failures caused by incompatible package managers (e.g., apk, yum) and to set clear expectations for custom template creation.

Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This pull request is from a fork — automated review is disabled. A repository maintainer can comment @claude review to run a one-time review.

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.

3 participants