Custom Docker images
Enterprise plans
For developers
Enterprise customers can build and deploy custom Docker images to create standardized environments for their organization. These Docker images can be used on a per-Project basis.
Create a Dockerfile
When creating your Dockerfile, you may want to:
- Include frequently used tools and packages
- Pin specific versions of dependencies
- Add OS-level packages your projects need
An example Dockerfile is included below.
FROM docker.io/builderio/fusion-base-arm64:node22
# Add custom OS packages
RUN apt-get update && apt-get install -y git jq postgresql-client
# Install global tools your team uses
RUN npm i -g turbo pnpm@8
# Optional: pin dev-tools version
RUN npm i -g @builder.io/dev-tools@latest
To make your Dockerfile accessible to your Builder Project, build your custom Docker image and then push to GitHub Container Registry (GHCR).
For private Docker images, use the Desktop application.
Configure your Builder Project
To configure your Builder Project with your Docker image:
- Go to your Projects page.
- Click the three-dot menu on your Project.
- Choose Project settings.
- Go to the Advanced tab.
- Navigate to the Docker Image Path heading.
- Enter your Docker image's path.
- Click Save.
After clicking Save, your Project now uses your Docker image for setup. Test Project setup by creating a new branch.
Was this article helpful?