Getting started

Up and running in five minutes. Make a key. Rent. Connect.

Never used SSH? That’s fine. Follow these steps in order, from making a key to your first GPU job, and you’ll be logged in to your own GX10 as root.

Show commands for

Part 1

Get connected

Make an SSH key

An SSH key is how your computer proves it’s you, with no password to type. It’s a pair of files: a private key that never leaves your computer, and a public key you give to Madeful.

Open Terminal (in Applications, then Utilities). When you make a key, press Enter to keep the usual place, then choose a passphrase you’ll remember.

Terminal
# Already have a key? This prints its name if so
ls ~/.ssh/id_ed25519.pub
# If not, make one
ssh-keygen -t ed25519 -C "you@example.com"

Copy your public key

Your public key is one line that starts with ssh-ed25519. It lives in ~/.ssh/id_ed25519.pub.

Only ever share the file ending in .pub. The one without it is your private key: keep it on your computer and never paste it anywhere.

Terminal
# Copies your public key, ready to paste
pbcopy < ~/.ssh/id_ed25519.pub

Add it to your control panel

In your control panel, find SSH keys, choose Add a key, give it a name you’ll recognise and paste the key in.

Connecting from more than one computer, or sharing the node with a colleague? Add each person’s or computer’s key. Keys added while your node is running go on straight away.

Create your account

Rent a node

Pick an hour, a week or a month and pay by card. Hourly rentals save your card and charge for the hours you use.

Your node is ready a minute or two later. Your control panel and an email both show the exact command to connect.

See pricing

Connect

Your node is reached through Cloudflare, so it works on any network, even ones that block unusual ports. Install Cloudflare’s small connector, cloudflared, once. It’s free and runs only while you’re connected.

Then paste the command from your control panel. The first time, SSH asks whether you trust the node: type yes and press Enter. If you set a passphrase, it asks for that too.

That’s it: you’re root on your own GX10, with the GPU and CUDA ready. To leave, type exit.

Terminal
# Once: install Cloudflare’s connector (with Homebrew, brew.sh)
brew install cloudflared
# Then connect
ssh -o ProxyCommand="cloudflared access ssh --hostname %h" root@ssh.madeful.app
Are you sure you want to continue connecting (yes/no)? yes
Welcome to your Madeful node.
# You’re in, as root. Check the GPU and CUDA
nvidia-smi
nvcc --version

Part 2

Work on your node

Connect with one word

Save your node’s details once and connect with ssh madeful from then on. It works with copying files and VS Code too.

Using VS Code? Install Microsoft’s Remote - SSH extension, choose Connect to Host, then madeful, and edit files on the node as if they were on your computer.

Terminal, then the file
nano ~/.ssh/config
# Add these lines and save
Host madeful
  HostName ssh.madeful.app
  User root
  IdentityFile ~/.ssh/id_ed25519
  ProxyCommand cloudflared access ssh --hostname %h
# From now on, this is all you need
ssh madeful

Move files

Run these on your own computer, not on the node. Your home folder on the node is /root.

They use the madeful shortcut from step 6, which tells scp and rsync how to reach your node through Cloudflare.

For code, you can also git clone straight onto the node: git is already installed.

Terminal
# Upload a folder to the node
scp -r ./my-project madeful:/root/
# Download results to your computer
rsync -av madeful:/root/my-project/ ./my-project/

Install your tools

Your node runs Ubuntu 24.04 with CUDA 13, Python 3, git, tmux, rsync and the usual build tools. You’re root, so install anything else with apt or pip.

The GB10’s CPU is Arm (aarch64), not Intel or AMD. Choose Arm64 builds of software, containers and Python packages.

On your node
# Keep Python packages in their own environment
python3 -m venv ~/venv
source ~/venv/bin/activate
pip install --upgrade pip
# Then install what your project needs
pip install -r requirements.txt

Keep long jobs running

If your laptop sleeps or your Wi-Fi drops, anything running in a plain SSH session stops. Run training and long jobs inside tmux and they keep going.

Watch the GPU while it works with nvidia-smi -l 2, or see live numbers in your control panel.

On your node
# Start a session that survives disconnecting
tmux new -s work
# Run your job, then press Ctrl+B, then D, to leave it running
# Later, after you reconnect, pick it back up
tmux attach -t work

Before your rental ends

Weekly and monthly rentals end on their own, and we email you the day before. Hourly rentals run until you end them in your control panel.

When a rental ends, the node is wiped and everything on it is deleted for good. Download your results first (step 7), or extend the rental from your control panel.

If something’s not right

Quick fixes

SSH says permission denied

Permission denied (publickey)

The node doesn’t have the key you’re using. Check it’s in your control panel, or point SSH at your key:

Terminal
ssh -i ~/.ssh/id_ed25519 -o ProxyCommand="cloudflared access ssh --hostname %h" root@ssh.madeful.app

SSH warns the host has changed

REMOTE HOST IDENTIFICATION HAS CHANGED!

Every rental starts on a freshly built node with new host keys. If you’ve rented before, forget the old ones and connect again:

Terminal
ssh-keygen -R ssh.madeful.app

It won’t connect

websocket: bad handshake

Or cloudflared: command not found. Check the connector is installed: cloudflared --version should print a version (step 5). Otherwise your node may still be setting up, or the rental has ended: check its status in your control panel.

A program won’t start

exec format error

That software was built for Intel or AMD. The node is Arm (aarch64), so install the Arm64 version instead.

A job stopped when I disconnected

Anything in a plain SSH session stops when you disconnect. Run it inside tmux (step 9) and it carries on without you.

Still stuck? Tell us what you tried and what it printed, and we’ll help you get connected.

Talk to us

Ready when you are.

Your own GX10, root over SSH, by the hour, week or month.

Rent a nodeSee pricing