bl push
Build and push a container image to the Blaxel registry
Synopsis
Build and push a container image to the Blaxel registry without creating a deployment.
This command packages your code, uploads it, and builds a container image that
is stored in the workspace registry. Unlike ‘bl deploy’, this command does NOT
create or update any resource (agent, function, sandbox, or job).
The process includes:
- Reading configuration from blaxel.toml
- Packaging source code (respects .blaxelignore)
- Uploading to Blaxel’s build system via presigned URL
- Building container image
- Streaming build logs until the image is ready
You must run this command from a directory containing a blaxel.toml file.
Examples
# Push current directory as an image
bl push
# Push with a custom name
bl push --name my-image
# Push a specific subdirectory
bl push -d ./packages/my-agent
# Push specifying a resource type
bl push --type agent
Options
-d, --directory string Source directory path
--docker-config string Path to a Docker config.json file with registry credentials
-h, --help help for push
-n, --name string Name for the image (defaults to directory name)
-c, --registry-cred stringArray Registry credentials (format: registry=username:password, repeatable)
-t, --type string Resource type (agent, function, sandbox, job). Defaults to blaxel.toml type; required if not set
-y, --yes Skip interactive mode
Options inherited from parent commands
-o, --output string Output format. One of: pretty,yaml,json,table
--skip-version-warning Skip version warning
-u, --utc Enable UTC timezone
-v, --verbose Enable verbose output
-w, --workspace string Specify the workspace name
SEE ALSO
- bl - Blaxel CLI - manage and deploy AI agents, sandboxes, and resources
Last modified on April 15, 2026
