Subdomains
Use subdomains to host your agents on custom, branded URLs. SmythOS supports custom subdomain verification through DNS and lets you connect verified domains directly during deployment.
TL;DR – Custom Domains in SmythOS
Add a New Subdomain
To link a custom subdomain to your agent:
-
Click
Add Subdomain
- You'll find this in the Subdomains section of your workspace.
-
Enter the Subdomain
- Input the subdomain you'd like to use (e.g.
support.yourcompany.com
) - Click
Next
to move to the DNS verification step.
- Input the subdomain you'd like to use (e.g.
-
Register a CNAME Record
- Copy the CNAME and target values shown.
- Add them to your DNS provider's dashboard.
DNS Propagation Time
- Verify
- After saving the DNS record, return to SmythOS and click
Verify
. - If successful, your subdomain will be listed as "Verified".
- After saving the DNS record, return to SmythOS and click
Cloudflare Users
Use a Verified Subdomain for Deployment
Once verified, your subdomain can be selected when deploying any agent.
- Go to your agent’s Deploy screen.
- Choose a version and fill out the details.
- In the domain dropdown, select your verified subdomain.
- Complete the deployment.
Your agent will now be live on your custom URL.
Need Help Deploying?
Delete a Subdomain
-
Click
Delete
- Found next to the subdomain in the list.
-
Confirm
- Type the subdomain name when prompted and click
Delete
again to confirm removal.
- Type the subdomain name when prompted and click
Best Practices
Naming Conventions
To stay organized, use descriptive and structured naming:
-
Use a consistent pattern, e.g.:
{agent-name}.agents.yourdomain.com
-
Keep names short but clear.
Multi-Agent Workspaces
One DNS Zone, Many Subdomains
- You can verify and use multiple subdomains in a single SmythOS workspace.
- Each subdomain must be added and verified separately, even if they share a root domain.