Smoozy

Help

In the order of a job, from renting a server to deleting it.

New to Smoozy? With no servers added, Smoozy lists the first steps.

1 · Before you rent

What server should I rent?

Check the NVIDIA driver before you pay. On a server that runs inside a container, the driver can't be updated, and most rented servers are containers. So rent one that already has driver 580 or newer. If the provider shows a CUDA version instead, look for 13.0 or newer.

Look for the number on the provider's page for the server. If it isn't there, ask the provider. Smoozy also shows the driver version when it first connects.

The server also needs:

  • Ubuntu or Debian. Other Linux distributions are not supported.
  • An Intel or AMD processor. Not ARM.
  • An NVIDIA GPU. A job renders on one server, and Cycles uses all its GPUs.
  • Enough free disk for your .blend, its textures and every frame.
Which image or template do I pick?

A plain Ubuntu 22.04 or 24.04 image. The provider's own base image built on Ubuntu or Debian is fine too. Some providers call the image a template.

SSH must be on. Its port is whatever the provider gives, often not 22. It is in the SSH command you paste into Smoozy.

Nothing else in the image is needed. Setup installs Blender and what it needs to render. Images with extra tools, like machine-learning frameworks, only take up disk space.

For the GPU and its driver, see What server should I rent?

Does Smoozy rent the server?

No. You rent it from any provider that has the server above and lets you reach it over SSH. You pay them directly.

2 · Adding a server

Where does my SSH key go?

Make a key in Smoozy's Keys, with your provider's name in Name, and copy its public key. Add it on your provider's SSH keys page before you rent the server, so the server is created with it. If that page asks for a name, call it smoozy.

The New key box, with Name and the line Use your provider's name.
Could not connect

The reason follows Could not connect:

  • the server refused the key for this username. The public key isn't on the server, or the username is wrong. Add the key at your provider before you rent the server, and copy the username from its SSH command.
  • the server refused the connection on this port. Check the port. It is often not 22.
  • host not found. Check the host, and that your computer is online.
  • no answer from this address. or timed out. The server may still be starting, or be stopped. Check that it is running at your provider, then press Connect.
  • the key could not be loaded. The key file could not be read. Check it in Keys.

Your provider usually shows one SSH command with the host, port and username. Paste it into Host in Add a server to fill in the fields.

Add a server, with Host, Port and Username filled in from a pasted SSH command.
This step needs the server's login password

A step needs administrator rights. Enter the server login's password from your provider. It is not your key's passphrase.

3 · Setting it up

What does setup do?

It installs what the server needs to render, and the Blender versions you select. It may restart the server. You can watch every line the server prints.

If it stops part-way, press Set up again. It resumes where it stopped.

The Set up tab of the 4x4090 server part-way through setup: the steps on the left, Install the GPU driver running, and the server's newest lines beside them with Server output under them.
The NVIDIA driver is too old, or has no OptiX

Setup updates the driver where it can. On a server in a container, it can't.

  • Too old: pick an older Blender version, render on the CPU, or rent another server.
  • No OptiX library: Cycles can't render on the GPU. Render on the CPU, or rent another server.

4 · Sending a job

Where do I put my files on the server?

In your home folder, or on a bigger disk. Your home folder is /root, or /home/ plus your login's name. It's yours. The system keeps its own files elsewhere.

Leave the system folders alone: /bin, /etc, /usr, /var and the like. Don't keep work in /tmp. It can be emptied when the server restarts.

Some servers have a second, bigger disk. Linux has no drive letters, so it is mounted as a folder: for example under /mnt, or a folder of its own. Where there is one, setup puts Smoozy's own folder there, and the free space shown for the server is that disk's. Put a big project there too.

An upload goes to the folder you have open in Smoozy's Files. The bottom bar names it, and shows the free space on its disk. Check it before you upload a big project.

Files on the 4x4090 server, open at root, the home folder, with a house before its name. The bottom bar says Uploads go to root/ and 412 GB free on this server.
Do I need Pack Resources?

No. Smoozy finds your textures and other files on your computer, and you upload them once. Smoozy points the .blend on the server at them. The .blend on your computer is not changed.

The dependency check can't find a file

Add the folder the file is in with Search folders…, or pick the file yourself with Locate…. Where two files share a name, check which one it picked.

The dependency check with critter-normals.tif missing, Locate… on its row and Search folders… above the list.
Do I have to press Read the file?

No. Without a read, the job renders with the settings saved in your .blend, plus any you change. Read the file shows its frame range, scenes, View Layers and samples, so you can check them first.

A read opens your .blend in Blender on the server, and it can take minutes. You can press Render while it runs.

What does Render one frame first do?

Turn it on in Render settings, and only the job's first frame renders. Look at it in the Queue, or on your phone with Telegram, then press Render all or Cancel job. Render all renders the whole range, the first frame included.

While a job waits for your answer, the server's other jobs keep rendering. With nothing else queued, the server waits, and your provider still bills.

The Queue while the first frame of 100_0040-lighting.blend waits for an answer: the row says Needs your answer, and the box shows frame 330 with Render all — 116 frames and Cancel job.
macOS may be asking for access to a folder

The dependency check reads your textures to upload them. The first time it reads your Documents, Desktop or Downloads folder, macOS asks whether Smoozy may use it. Click Allow.

If you clicked Don't Allow, the check can't read files there. To change it, choose Apple menu, System Settings, then Privacy & Security, then Files & Folders, and turn the folder on under Smoozy. On macOS 12 or earlier, it is System Preferences, Security & Privacy, Privacy, then Files and Folders.

5 · While it renders

Can I close Smoozy or turn my computer off?

Yes. The queue is on the server and keeps rendering. Open Smoozy and connect to see its progress.

Can I watch a render on my phone?

Turn on Telegram in Smoozy's Settings. It shows the steps to create a bot. One bot works for every server.

What can I ask the Telegram bot?

Type / in the chat to see the list.

  • /status: every server, in one message.
  • /frame: the newest finished frame. /frame 120 sends frame 120.
  • /stop: stops a job, after you confirm. With more than one job, it asks which.
  • /reporting: what the bot sends, for every job and for new ones.

Send a command as a reply to a job's message, and it applies to that job only.

6 · Getting your frames

Where do my frames go?

On the server, to the output folder your .blend names, in a folder for each job. If that folder can't be used, they go to the server's fallback folder, and the job says so.

With Download frames as they render on, each frame is downloaded to your computer as soon as it is rendered.

7 · When you are done

Servers come and go. When you finish a project, delete its server at your provider, so it stops being billed.

Does Smoozy turn the server off?

No. Your provider bills you until you stop or delete the server there. While Smoozy is connected, it tells you when a server has had no jobs for 30 minutes. With Telegram on, so does the bot.

Download your frames before you delete the server: once it is deleted, they are gone. History stays on your computer.

Still stuck?

In Smoozy's menu, Report a problem… saves one file with what Smoozy did and what the server said. Email it, or attach it to an issue on the issue list. Issues are public, so read the file first.

hello@smoozy.app

One person reads that. It may take a day.

© Alexander Kislyakov· Terms·Privacy·Licences·Contact