Choosing Worker or Web

You must pick a process mode at submit. There is no default. The mode controls whether Velcio gives your delivery a public HTTPS hostname and how live review works for the buyer.

Web if anything outside Velcio must hit your app over HTTPS. That includes a site, an API, webhooks and OAuth callbacks.

Worker if it is a long-running process with no public HTTP URL. Workers are outbound only. They do not get a *.velcio.app hostname.

Most projects are Web on *.velcio.app. Use Worker only when there is no inbound traffic.

Examples

Example	Mode	Why
Website or small web app on *.velcio.app	Web	Public HTTPS
HTTP API or dashboard	Web	Public HTTPS
Stripe / Slack / WhatsApp webhook	Web	Provider POSTs to a public URL
OAuth redirect / callback	Web	IdP must reach your app
Poller or scheduler calling APIs on a timer	Worker	Outbound only
Background job with no HTTP server	Worker	No hostname

Web

• Public HTTPS at https://{slug}.velcio.app
• Bind 0.0.0.0 and env PORT (Velcio sets 8080). Implement GET /healthz with HTTP 2xx yourself
• Wrong port → public 502 even if the container looks fine
• Details: Web delivery format

Worker

• Long-running container, no public hostname
• Logs and deploy controls on the project page
• Packaging: Delivery format

Changing mode

Mode is chosen when you submit. To switch, agree it in Discussion and submit a new delivery in that mode.

See also: Developer workflow.