runtm deploy
Deploy your agent’s work to a live HTTPS URL. Your agent can use this URL to test, share, and iterate.Arguments
Options
Examples
Basic Deployment
Machine Tiers
Auto-Fix Issues
Quick Config Changes
Non-Blocking Deploy
JSON Output for AI Agents
Deployment Flow
Redeployment
When you deploy a project with the same name, Runtime automatically redeploys:- URL stays the same
- Secrets are preserved
- Custom domains are preserved
- Version number increments
Force New Deployment
Use--new to create a completely new deployment:
Machine Tiers
All tiers use suspended state - machines pause when idle and resume quickly on requests.
The
web-app template requires standard or higher.Config-Only Deploys
Use--config-only for fast updates that don’t change code:
Validation
The deploy command validates your project:- Manifest -
runtm.yamlis valid - Lockfile - Dependencies are locked
- Imports - Python imports work (optional)
Skip Validation
Force Re-validation
Output
Successful deployment shows:Troubleshooting
Lockfile error
Lockfile error
Fix automatically:Or manually:
Artifact too large (> 20MB)
Artifact too large (> 20MB)
Update
.runtmignore to exclude:Build timeout
Build timeout
Large dependencies can cause timeouts. Consider:
- Using smaller base images
- Caching dependencies
- Removing unused packages
Health check failed
Health check failed
Ensure
/health endpoint:- Returns 200 status code
- Responds within 100ms
- Works without authentication
Import validation failed
Import validation failed
Check
pyproject.toml has runtime dependencies in [project] dependencies, not [project.optional-dependencies] dev.Related Commands
runtm status- Check deployment statusruntm logs- View deployment logsruntm destroy- Remove a deployment