golemcloud Deploying a Golem Application with golem deploy
Both golem and golem-cli can be used — all commands below work with either binary.
Usage
golem deploy --yes
Run this from the application root directory (where the root golem.yaml is located). It automatically builds all components (with up-to-date checks), uploads them to the configured Golem server, and creates or updates the deployment. Always pass --yes to avoid interactive prompts.
What golem deploy Does
- Builds — automatically builds all components if needed, with proper up-to-date checks (same as
golem build). - Stages — compares local component artifacts with what is currently deployed on the server.
- Uploads — pushes new or changed component versions to the server.
- Deploys — activates the uploaded components so agents can be created and invoked.
Existing running agents are not affected by default — they continue running with their previous component version. Use --update-agents or --redeploy-agents to change this behavior.
Available Options
| Option | Description |
|---|---|
--plan |
Only plan deployment, apply no changes |
--force-build |
Skip modification-time based up-to-date checks |
-u, --update-agents <MODE> |
Update existing agents: automatic or manual |
--redeploy-agents |
Delete and recreate existing agents |
-r, --reset |
Delete agents and the environment, then deploy from scratch |
-P, --preset <PRESET> |
Select custom component presets |
-Y, --yes |
Non-interactive mode — always use this flag |
Environment Selection
| Option | Description |
|---|---|
-E, --environment <NAME> |
Select a Golem environment by name |
-L, --local |
Use local environment or profile |
-C, --cloud |
Use cloud environment or profile |
--profile <PROFILE> |
Select a Golem profile by name |
Deployment Strategies
Fresh deployment
golem deploy --yes
Builds, uploads, and activates all components. Agents are created on first invocation.
Iterative development (recommended)
golem deploy --yes --reset
Deletes all previously created agents and redeploys everything. Use this when iterating on code changes — without it, existing agent instances keep running with the old component version.
Update running agents in-place
golem deploy --yes --update-agents automatic
Updates existing agents to the new component version automatically. Agents pick up the new code on their next invocation.
Preview changes without applying
golem deploy --yes --plan
Shows what would be deployed without making any changes.
Common Deployment Errors
- Build failure: fix the build errors reported in the output —
golem deployruns the build automatically. - Server not reachable: ensure the Golem server is running and accessible at the configured address.
- Port conflict: if deploying locally, make sure no other process is using the Golem server ports.
- Version-related errors (
tagPatternrequired, working tree dirty, version already exists): seegolem-deployment-version.
Related Skills
- Load
golem-deployment-versionfor the logical version attached to each deployment (git/static/env source,versionCheck). - Load
golem-rollbackfor reverting to a previous deployment. - Load
golem-profiles-and-environmentsfor selecting deployment targets.