Skip to main content

Quickstart to Deployment

This quickstart shows you how to publish an agent to Agent Cloud, the default runtime hosted by SmythOS.
In just a few clicks you’ll have a live HTTPS URL with versioning and autoscaling built in.

Other deployment options

You can also deploy to Enterprise (on-prem or VPC) or Local Runtime (offline/local dev). See the Deployments Overview for details.

Step 1: Open and Deploy

Open your agent in Studio. Click Deploy in the top right.

The Deployment panel appears with Agent Cloud already selected.

Agent Cloud deployment dashboard in SmythOS showing a live subdomain and deploy options

Agent Cloud gives you a secure, autoscaling URL out of the box.

Step 2: Configure Your Deployment

In the panel, set the key details:

  • Version number: Enter Major.Minor (for example 1.0, 1.1, 2.0).
    Each deployment must be unique. See the Versioning Guide if unsure.
  • Subdomain: Use the default SmythOS URL or set up your own domain.
  • Release notes (optional): Add a short summary of what changed, like Adds PDF export or Fixes Slack formatting.
Versioning rules

Once published, a version is immutable. You can always create a new version, but you can’t overwrite an existing one.

Step 3: Publish Your Agent

Click Deploy. SmythOS will:

  • Assign your version number
  • Provision your subdomain and SSL
  • Run health checks

When it’s ready, you’ll see your live agent URL.

What You Get

Immutable deployments

Every deployment is locked to its version. Rollback and history tracking are automatic.

  • A secure HTTPS URL you can share immediately
  • A record of deployments in Studio → Agent Settings → Deployments
  • Preserved history for auditing and rollback

Troubleshooting

If your URL doesn’t load
  • Wait 1–2 minutes for SSL provisioning
  • Refresh or test in a private window
  • Confirm your version number is unique
  • For custom domains, make sure DNS changes have propagated (see Subdomains Guide)

Next Steps