Expose ports from your Ona environment to share running services with teammates, test webhooks, or preview work without deploying.
How it works
When you open a port, Ona creates a URL with automatic TLS termination. All shared URLs use HTTPS. You can configure whether Ona connects to your service via HTTP (default) or HTTPS.
| Deployment | Access |
|---|
| Ona Cloud | Internal network - anyone with the URL can access |
| Enterprise Runners | Through your runner’s Network Load Balancer, controlled by your network configuration |
Prerequisites
Services must:
app.listen(3000, '0.0.0.0', () => {
console.log('Server running on port 3000');
});
Open ports
In the environment sidebar, find “Public Ports” and click “Open Port”. Enter the port number, optional name, and protocol.
CLI
gitpod environment port list
gitpod environment port open 3000 --name my-app
gitpod environment port open 3000 --protocol https
gitpod environment port close 3000
Open ports are accessible to anyone who can reach the URL. On Ona Cloud, this means anyone on the internal network. For Enterprise Runners, access depends on your network configuration.
Limitations
- Not available on local environments
- Subject to fair use policies and bandwidth limits
