Before you start: a paid Voyager workspace (Starter or above) and the
voyager CLI, signed in (quickstart). The machine bills by the second until you release it. render-lite (an L4) is the cheapest preset that renders Blender; render is faster for final frames.Render a scene in five commands
This example starts from product-sweep, one of the ready-made scene templates. It builds a lit product shot from library assets and renders a draft still.1
Write the scene template
shot/ on your computer: recipe.json (what goes where), build_scene.py (builds the scene in Blender), the render presets and a README.txt. Nothing is leased yet.2
Lease a machine
lease prints only the machine id on stdout, so $m holds it. It’s usually ready in under a minute.3
Push the scene
4
Render on the machine
product-sweep.blend beside the recipe and renders the still. On an L4 this took about 20 seconds.5
Pull the result and release
shot/out/product-sweep.png is on your computer. release prints how long the machine ran and what it cost.Tiers
--tier sets resolution, samples, denoising and bounces for one purpose:
Edit
shot/recipe.json to move things, swap assets (its swap list has alternatives) or change the tier. Add --hero model.glb --hero-size 0.3 to the render command to put your own product in the hero slot. Other templates: tabletop-food, interior-room, night-street, outdoor-nature and space (voyager cloud guide template lists them).
Your own .blend
Push the file and render it the usual way. The default image has two Blenders on the machine’sPATH: blender is Blender 5.2.4 LTS and blender-5.3 is Blender 5.3. A file saved by Blender 5.3 needs blender-5.3 (5.2 stops with “File written by newer Blender binary”); voyager cloud images lists every image’s tools. The machine picks the GPU (OptiX) for Cycles without any setup:
voyager cloud guide presets --renderer blender --to scene/ and run Blender with -P voyager_presets.py -- --tier preview.
Estimate a render
Before a long render, find out what it will take and cost:--yes skips that.
- Frame range: with Blender installed locally, it reads the frame range from the scene and warns about missing external files. Only the
.blendis sent, so pack external files first (File › External Data › Pack Resources). - The range: the estimate is a range. How much the sample frames differ from each other widens it, and so does converting from the sample’s GPU to yours.
- Assets: use library models, materials and HDRIs instead of uploading your own copies. See Assets on machines.
- Many frames: split a frame range over several machines with Farm a frame range.
- Versions:
voyager cloud imageslists each image’s tools and their versions, Blender’s included.
Blender’s UI in your browser
To work in Blender itself (look around a scene, fix a material, check a camera), open its UI from the machine in your browser. The machine needs thecreative-view image and a GPU with a video encoder, so any render preset works; H100, A100 and B200 don’t.
view starts a desktop on the machine and opens https://app.voyager.so/view/<machine>. Sign in with Voyager there; only you (the machine’s starter) and your workspace’s admins can open it, and the link works for no one else. Blender runs on the machine’s GPU and streams to the tab; your mouse and keyboard drive it. The desktop ends after 15 minutes without input, or with voyager cloud view $m --stop; the machine keeps running until it idles or you release it. API: POST /v1/machines/{id}/view.
If something went wrong
exec says MACHINE_PAUSED, or the CLI says it resumed the machine
exec says MACHINE_PAUSED, or the CLI says it resumed the machine
The machine paused itself after 15 minutes without a command, file transfer or busy GPU.
exec, push and pull resume it first and say so; billing starts again. Pass --no-resume to fail instead.The render is black or missing textures
The render is black or missing textures
Check that every path in the scene is relative to the
.blend (//textures/…), and that you pushed the textures with it. For library assets, run voyager-cloud assets sync on the machine (Assets on machines).Next
Farm a frame range
Render an animation across several machines at once.
Assets on machines
Find library models, materials and HDRIs and put them on the machine.