> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create service

> Register a managed User Service on your Zo server.

{/* Tool: register_user_service */}

A User Service is an automatically managed process on Zo Computer.

Service modes:

* "http" — public or private web service with a URL endpoint
* "tcp" — public TCP service with a host:port endpoint
* "process" — supervised background process with no public endpoint (workers, schedulers, bots, sync loops, or internal-only localhost services like Postgres bound to 127.0.0.1)

Use "process" for anything that doesn't need to be reached from outside the host. Process-only services do not count toward hosted-service limits.

Visibility (HTTP only):

* public (default): reachable at \*.zocomputer.io without auth
* private: reachable at \*.zo.computer, requires the owner to sign in. Private services are gated by a feature flag and not available on all accounts.
* TCP services are always public. Process services have no endpoint.

## Parameters

<ParamField path="label" type="string" required={true}>
  Unique label (per host) for the service. Lowercase and hyphens allowed. e.g. "my-web-app".
</ParamField>

<ParamField path="mode" type="string" required={true}>
  "http", "tcp", or "process". Use "process" for internal-only localhost services or non-network background processes.
</ParamField>

<ParamField path="local_port" type="number" default={-1}>
  Localhost port to expose (1-65535, injected as PORT env var). Required for "http" and "tcp". Omit for "process".
</ParamField>

<ParamField path="entrypoint" type="string" default={""}>
  Optional command to run the service, e.g. "python3 -m http.server %(ENV\_PORT)s". If omitted, only the tunnel is managed.
</ParamField>

<ParamField path="workdir" type="string" default={""}>
  Working directory for the service entrypoint. Defaults to /home/workspace.
</ParamField>

<ParamField path="env_vars" type="object" default={{}}>
  Optional environment variables. PORT will be overridden for networked services and is not set for process-only services.
</ParamField>

<ParamField path="public" type="string" default={""}>
  Whether the service is publicly accessible (defaults to true). Only applies to HTTP services — set to false for a private service at \*.zo.computer that requires sign-in. TCP services are always public; process services have no endpoint.
</ParamField>