Hosted App Not Loading
Published February 28, 2026 · Last updated June 24, 2026 · 3 min read
When a hosted app won't load, the cause is almost always one of four things: a stopped service, a slow cold start, a port mismatch, or a missing dependency. Each has a straightforward fix.
Blank page or "site can't be reached"
The app isn't running — something went wrong when it tried to start.
Open the project and ask the agent: "Is my hosted service running?" If it's down, ask the agent to restart it and include the port number you used when you set it up. If it still won't start, ask the agent to check the build logs for errors. Once the agent confirms the service is healthy, refresh the URL.
Spinner that won't finish
This is common after a URL hasn't been visited in a while. Obvious pauses apps that haven't been used recently; visiting the URL wakes the app back up automatically. If something goes wrong during startup, the page hangs instead of loading.
Wait about 30 seconds and refresh. The first visit triggers the wake, and a second refresh often catches it. If the page is still loading, open the project and ask the agent to check the health of your hosted service. If your app has a lot of dependencies, startup can exceed the allowed time — ask the agent to simplify the install command to speed things up.
Port mismatch
The port registered with Obvious doesn't match the port your app is actually listening on.
Ask the agent: "What port is my hosted app registered on?" Compare that to the port in your project code. If the ports don't match, ask the agent to re-register the app with the correct port. If another process is already using that port, ask the agent to stop it and restart your app.
App worked before but fails now
Your app ran fine before, but after a period of inactivity it won't start.
Obvious re-runs the startup command each time it wakes your app. If that command depends on a package or file that isn't available, the app won't start. Ask the agent to show the startup logs and look for messages about missing packages. Then ask the agent to update the install command to include all required dependencies, and restart the app — future wake cycles will use the corrected setup.
Still stuck?
Contact Obvious support at help@obvious.ai with your project name, port number, and what you see at the hosted URL.