Skip to main content
A public URL serves one port on a computer at an address like https://cool-thing-x7k2.orgo.dev, with HTTPS, to anyone who has the link. Use it to show a site an agent built, share a dashboard, or receive webhooks.
Public URLs need a paid plan or credits you’ve bought. They work on Linux and Windows computers.

​
Listen on 0.0.0.0

The app must listen on 0.0.0.0, not 127.0.0.1 or localhost, or the URL can’t reach it:
Most dev servers have a host flag for this, such as --host 0.0.0.0.

​
Create one

In the dashboard, open the computer’s ⋯ menu, choose Public URLs, enter the port and an optional name, and click Add. With the API:
Use the url in the answer. Orgo adds 4 characters after the name, so the address can’t be known in advance.

​
Names

  • 2 to 16 lowercase letters, digits and hyphens, starting and ending with a letter or digit. No --, and not only digits.
  • Orgo refuses names that use orgo, bops, brand names or words common in phishing.
  • Leave out name and Orgo picks one, like keen-otter-x7k2.

​
Ports

Any port from 1 to 65535, except the ones the computer uses itself: 22, 3389, 5900 to 5999, 6080 to 6099, 8080 and 9000. A computer has one URL per port. To serve another port, update the URL or make a new one.

​
Password

Set a password to keep a URL private:
  • Browsers see a password form first. Any other request without the form’s cookie, such as an API call, a WebSocket or a webhook, gets 401. Keep a URL that receives webhooks open.
  • A program can send the cookie from Get public URL password instead of filling in the form.
  • A new password signs out everyone who entered the old one. "password": null removes it.
  • Changes are live within 5 seconds.

​
Limits

List public URLs returns limit, the most this computer can have, and account_limit, the most the workspace owner can have across all their computers. Each person can make 30 new URLs a day, reset at 00:00 UTC.

​
When the computer is off

While the computer is stopped or asleep, the URL shows a page saying the computer isn’t running. It serves the app again once the computer starts.

​
Remove one

Removing a URL stops serving it. The app on the computer keeps running. For 30 days, only the workspace owner can take the address back, by sending its full label, for example "label": "cool-thing-x7k2", to Create public URL.
Where public URLs aren’t on for your account, List public URLs answers enabled: false and the other calls answer 404.

​
API