Getting started
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.
Part 1
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.
# 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"
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.
# Copies your public key, ready to paste $ pbcopy < ~/.ssh/id_ed25519.pub
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 accountPick 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 pricingYour 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.
# 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
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.
$ 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
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.
# 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/
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.
# 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
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.
# 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
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
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:
$ ssh -i ~/.ssh/id_ed25519 -o ProxyCommand="cloudflared access ssh --hostname %h" root@ssh.madeful.app
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:
$ ssh-keygen -R ssh.madeful.app
websocket: bad handshakeOr 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.
exec format errorThat software was built for Intel or AMD. The node is Arm (aarch64), so install the Arm64 version instead.
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 usYour own GX10, root over SSH, by the hour, week or month.