This page covers what the appliance is and what to plan for. The commands, tuning
options, and troubleshooting are in the All-in-One guide, which you download from
Developer → Self Host with the image version you run.
What it cannot do
The appliance runs one inference worker and one vocoder, on the cards its model takes — see Models. A container does not scale itself: for more capacity, run more containers behind your own load balancer. To scale workers and vocoders separately, use the Kubernetes chart.What running it involves
Onedocker run on a host that meets the
requirements.
It needs:
- The GPUs its model takes — usually two; a Single-GPU mode, where the model offers one, shares one card at lower throughput.
- One exposed port for the API.
- One persistent volume. Caches, reference voice archives, and — in the offline mode — the usage ledger all live there; the model weights do not.
- The license bundle from Developer → Self Host, mounted read-only. See The license.
Tokens and tenancy
Offline, any non-empty bearer token is accepted and recorded as the billing identity: give each tenant a stable token of its own, and control access in front of the appliance. Online, each request must carry a Fish Audio API key with credit, not the deploy token. It is authorized against Fish Audio with no local fallback, so treat outbound reachability as a production dependency.Capacity
The worker admits a bounded number of requests at once; beyond that, requests queue and time-to-first-audio climbs. Your deployment guide gives the cap for your model; validate latency and error rate before changing it.Next steps
- Requirements: host baseline
- Registry & license: how your team gets the image
- Air-gapped deployments: moving the image to a disconnected host

