Sogni: Learn logo
Markdown

Run a Sogni Comfy Worker on Vast.ai

On Vast.ai, rent one GPU and run the Sogni container as a regular instance. Keep your Sogni worker key, Fast Worker NFT token ID, and hardware requirements handy.

#Create a private instance template

  1. Open Vast.ai Templates and create a private template, or edit a template and save a private copy.
  2. In Image Path:Tag, enter sogni/comfy-worker-cu13:latest or the recommended versioned image.
  3. Set Launch Mode to docker ENTRYPOINT and leave entrypoint arguments blank. SSH and Jupyter launch modes replace the image’s normal startup command. Clear inherited port mappings and leave other launch options at their defaults.
  4. Set API_KEY and NFT_TOKEN_ID in Environment Variables. Vast.ai allows people with the URL to use a private template, so keep both the URL and any generated launch command private. Choose disk space for Docker and model files as described below.
  5. Click Create & Use and filter offers to one GPU on a verified x86-64 host. Check the driver is R580 or newer, the allocated system RAM and disk meet your workload’s needs, and the offer’s bandwidth and transfer charges work for the expected model downloads. Vast.ai guide to comparing offers
  6. Rent the instance, open its logs, and verify that the NFT is online in Sogni. If the container fails to start on an otherwise suitable offer, check the instance status and the host’s startup error before trying a different verified host.

For field names and launch modes, see Vast.ai Template Settings.

#Keep the model cache between instances

The instance disk survives a stop and is deleted when you destroy the instance. To reuse downloaded models after replacing an instance on the same machine, enable Add recommended volume settings in the template editor and set the installation path to /data-models. Give that volume enough space for the model cache, and still allocate instance disk space for the image, logs, and worker state. A volume mounted at Vast.ai’s default /data path preserves worker state. The model cache uses a separate path.

Use the Storage page to reattach a local volume on the same host. Before destroying an instance, back up any data you want to keep. Stopped instances and retained volumes can still incur storage charges. See Vast.ai storage types and Volumes.

Last updated 2026-11-20