Docs /
... / App Configuration / Attach domains and tunnels to an app

Attach domains and tunnels to an app

Manage custom domains, subdomains, IP addresses, and .odac.cc tunnel addresses for any web-enabled app from its right-hand inspector drawer at app.odac.run. From the Domains section, you can attach new addresses, open live links, inspect or remove individual subdomains, and delete domains or tunnels.

Add a domain, subdomain, IP address, or tunnel

  1. Open the app's inspector drawer from the Canvas (see Inspect, rename, restart, and delete an app) and look under Domains at the top of the configuration sections. Apps that expose a web port or already have an attached domain or tunnel show Domains, while non-web services hide it. Click Add Domain.

Inspector drawer for shop with the Domains section showing a tunnel pill and the pointer hovering over Add Domain

  1. The Add Domain button expands into an inline text field with the placeholder domain.com. Type a custom domain (such as example.com), a subdomain (such as api.example.com or a wildcard *.example.com), an IPv4 or IPv6 address (such as 203.0.113.10), localhost, or a .odac.cc tunnel subdomain (such as shop-demo.odac.cc), then press Enter. Press Escape or click outside the field to cancel without saving. If the format is not valid, the field shakes and ODAC shows Invalid domain or IP format. For .odac.cc tunnels, only single-level subdomains of at least 4 characters (lowercase letters, numbers, and hyphens starting and ending with a letter or number) are allowed, and each app can have one tunnel at a time.

Domains section with Add Domain expanded into an inline text field containing example.com

  1. While ODAC applies the change, a pulsing pending pill with a spinner appears in Domains (or an existing parent domain pill pulses while a new subdomain is added). When complete, ODAC displays Domain added successfully. for domains, subdomains, and IPs, or Tunnel created. for .odac.cc tunnels, and shows the pill in Domains with a globe icon for standard domains or a lock icon for tunnels. If the app uses Host network mode, ODAC shows This app runs on the host network, switch it to bridge to serve a domain (switch the app to Bridge in Settings first; see Configure ports, networks, and volumes). If the server is disconnected, ODAC shows Cannot add domain while server is disconnected..

Domain added successfully notification above the inspector drawer with example.com added alongside the tunnel pill

Open an attached domain or tunnel

  1. Click any domain name or lock-badged .odac.cc address in Domains to open its https:// address in a new browser tab. To review uptime history, SSL certificate expiration, and visitor access rules (such as client certificates for custom domains or account sign-in and device certificates for tunnels), open Domains from the left sidebar (see View domains, tunnel usage, and uptime and Tunnel sign-in and device certificates).

Domains section with the pointer hovering over the example.com link pill

Inspect and delete individual subdomains

  1. When a domain has attached subdomains (other than www alone), its pill displays a count badge on the right, such as +2. Hover over the count badge to open a popover listing each full subdomain host, where you can select any address to copy it.

Example.com pill with a +2 subdomain badge hovered and the glass popover listing api.example.com and admin.example.com

  1. To delete a single subdomain without removing the root domain, hover over its row in the popover to reveal the × button on the right and click it. The row turns red with a SURE? confirmation overlay; moving your pointer off the row cancels the confirmation.

Subdomain popover with the api.example.com row switched to the red SURE? confirmation overlay

  1. Click SURE? to confirm. The row collapses out of the popover, the parent domain pill dims briefly, ODAC displays Domain removed., and the pill updates its subdomain count badge (or removes the badge if no other subdomains remain).

Domain removed notification with the example.com pill updated from +2 to +1

Remove a domain or tunnel

  1. Hover over a domain pill or a lock-badged .odac.cc tunnel pill to reveal the × delete button on its right side (Delete Domain or Delete Tunnel), then click ×.

Lock-badged shop-a4f19c.odac.cc tunnel pill hovered with its red delete X button revealed and the pointer over it

  1. The pill flips to a solid red SURE? confirmation state. Moving your pointer away from the pill cancels the action and restores the pill.

Tunnel pill flipped into the solid red SURE? confirmation state with the pointer ready to confirm

  1. Click SURE? to remove the domain or tunnel. The pill dims while ODAC applies the change, then disappears from Domains as ODAC displays Domain removed. for a domain or Tunnel removed. for a tunnel.

Tunnel removed notification above the inspector drawer after shop-a4f19c.odac.cc is removed