Obvious/Help Center

Custom Domain Aliases for Hosted Apps

Published February 27, 2026 · Last updated March 7, 2026 · 2 min read

When you host an app in Obvious, it gets a URL automatically — something like prj-abc123-8080.hosted.obvious.ai. A custom alias replaces that with something readable, like sales-dashboard.hosted.obvious.ai. Both URLs work; the alias is just easier to share and remember.

Set Up an Alias

Tell the agent what alias you want when you ask it to host your app:

"Host my dashboard on port 8050 with the alias sales-dashboard"

The agent handles the rest. Once registered, your alias URL is permanent — it keeps working even when the sandbox is paused.

Alias Rules

Aliases follow standard web naming conventions:

  • Between 3 and 63 characters, lowercase letters, numbers, and hyphens only

  • Must start and end with a letter or number

  • Common system names (like admin, api, login, staging) are reserved and can't be used

  • Aliases are first come, first served — if yours is taken, the agent will suggest an alternative

Change or Update an Alias

Ask the agent to re-register your app with a new alias. It'll swap it out and clean up the old one automatically.

Things to Know

  • One alias per app. Each hosted app supports a single alias at a time.

  • Subdomains only. Aliases live under hosted.obvious.ai. Pointing your own domain (like dashboard.yourcompany.com) isn't supported yet.

  • 30-day activity window. Aliases expire if the app goes untouched for 30 days.

  • Feature availability. Custom aliases require the custom-hosted-domains feature to be enabled on your workspace.

Next Steps

Was this helpful?