Deploying Your Agent
SmythOS supports three deployment modes. You can start with one that fits your current setup and switch later without changing your code.
Understanding Your Deployment Options
SmythOS supports three distinct deployment paths; each is designed to match a different stage of development or production use case. Here's how to choose:
- Agent Cloud: Perfect for most users. It’s fast, managed, and requires zero infra knowledge.
- Enterprise Deployments: Tailored for organizations with strict security, compliance, or hosting needs.
- Local Runtime: Great for isolated dev/testing environments or air-gapped prototypes.
Comparison of Deployment Modes
Mode | Infrastructure | Who It's For | Highlights | How to Access |
---|---|---|---|---|
Agent Cloud | SmythOS-hosted | Builders & teams | Free subdomain, SSL, autoscaling | Agent Settings → Deploy → Agent Cloud |
Enterprise | Private / On-prem | Regulated enterprises | Custom SLAs, private cloud, full control | Contact Sales |
Local Runtime | Your local machine | Devs & offline testers | Lightweight, no internet needed | Download SRL → Run locally |
Choosing A Deployment Mode
Choose your deployment method through the Deploy
button in the top right corner:
Agent Cloud (Default)
Deploy your agent to SmythOS-hosted infrastructure, which is ideal for most use cases if you don't want to worry about infrastructure. It is:
- Preconfigured with staging domains like
youragent.agent.pstage.smyth.ai
- Has secure HTTPS served instantly
- Handles load without extra steps
Why Use Agent Cloud?
- You don’t want to worry about servers, scaling, or SSL certificates.
- You want to deploy instantly to a shareable live URL.
- You want free infrastructure for testing or lightweight production use.
Optional: Custom Domain Support
You can point your custom domain to SmythOS in three simple steps:
- Go to Subdomains
- Click Add Subdomain and enter the subdomain (e.g.,
test.smyth.com
) - You'll receive DNS instructions — create a CNAME record:
- Host:
test.smyth.com
- Target:
b3830d6590893c02fbab61b0e08b4f8c.proxy.pstage.smyth.ai
- Host:
- Click Verify after setting your DNS. It may take up to 24 hours for DNS changes to propagate.
Enterprise Deployments (On-Demand)
SmythOS supports highly customized deployments for organizations that need full control:
- On-premise or private VPC hosting
- Advanced network + data security
- Seamless LLM integration via custom endpoints
- Service-Level Agreements (SLAs) available
Local Runtime
Use Smyth Runtime Environment (SRE) for local testing and development. It is fast, private, and offline.
How to Deploy Locally
- Click
Export Agent
in Builder (Ctrl + Shift + E
orCmnd + Shift + E
) - Save the exported
agent.json
- Download SRL: GitHub → Smyth Runtime Local
- Run your agent locally:
srl run agent.json
Versioning & Changelog
Every deployment is semantic-versioned (Major.Minor
). See Versioning Guide for how version numbers work and when to increment them.
- Major = breaking workflow changes
- Minor = additive or bug-fix updates
Release notes are optional but recommended — users see them in Agent Settings → Deployments.
Which Mode Should I Use?
Mode | Best For | Highlights | Limits |
---|---|---|---|
Agent Cloud | Most users | Free test domain, SSL, autoscaling | None |
Enterprise | Regulated orgs | Private VPC / on-prem, custom SLAs | Contact Sales |
Local Runtime | Offline dev, POCs | Runs on laptop, free | No local models, no web server (beta) |
What’s Next?
- Want to deploy your first agent now? Start with the Deployment Quickstart
- Curious how versioning works? See the Versioning Guide
- Using your own domain? Follow the Subdomains Setup Guide