Rada tester guide

Your machines, on one private network, wherever they are.

Rada connects your laptops, servers and devices into a private, encrypted network. They can reach each other by name, through home routers and mobile networks, with no ports to open and no VPN server to run. Thanks for helping test it.

Early test build (0.1.0). Rada is new software, and you are among its first testers. It installs a system service and a network interface on your machine. Please test on a machine you are comfortable experimenting with, and send Ganesh whatever surprises you.

What Rada does

Each machine running Rada gets a stable private address such as 100.96.0.7 and a name such as your-laptop.rada.internal. Any two machines that are allowed to talk can reach each other directly, as if they were on the same network, even when both are behind home routers, office firewalls or a phone hotspot.

How it works

  1. You sign in with your email. The control server checks you were invited, gives your machine its address and name, and tells it which other machines it may talk to.
  2. Machines find each other. Each one learns its own public address and shares it through the control server. Two machines then reach out to each other at the same moment, which opens a direct path through most home routers.
  3. Traffic flows directly and encrypted between the two machines. If a network blocks the direct path, the same encrypted traffic is carried by the relay instead, and Rada keeps trying to go direct.
  4. Rules are enforced on each machine. Even if a machine is visible, it only accepts the connections the rules allow, plus replies to connections it started.

The control server never sees your traffic. It knows your email, your machines' names, their Rada addresses and the public addresses they connect from.

Download

Version 0.1.0. Checksums: SHA256SUMS.

macOSApple Silicon and Intel, macOS 12 or newer. Installs the Rada menu bar app and the background service.Rada-0.1.0.pkg
Linux serviceAny 64-bit Intel/AMD Debian or Ubuntu with systemd. Needed on every Linux machine.radanet_0.1.0_amd64.deb
Linux desktop appOptional tray app for Ubuntu 24.04 or newer with a desktop. Install the service too.Rada_0.1.0_amd64.deb

Install

First, get invited. Rada is invite-only. Send Ganesh the email address you want to sign in with, and wait until Ganesh confirms you were added. Otherwise no code will arrive.

macOS

  1. Download Rada-0.1.0.pkg and double-click it.
  2. This test build is not signed by Apple yet, so macOS will refuse to open it the first time. Open System Settings > Privacy & Security, scroll down, and click Open Anyway next to the Rada message. On macOS 14 and older you can instead right-click the file and choose Open.
  3. Follow the installer. It asks for your Mac password because it installs a background service.
  4. A Rada icon appears in the menu bar. Click it, enter your email, click Send code, and type the 6-digit code from the email from login@radanet.io. Check your spam folder if it does not arrive within a minute.
  5. The window shows your machine's name and address, and the other machines you can reach.

Linux (Ubuntu or Debian)

  1. Install the service:
    curl -fLO https://get.radanet.io/0.1.0/radanet_0.1.0_amd64.deb
    sudo apt install ./radanet_0.1.0_amd64.deb
  2. Sign in. You'll be asked for the 6-digit code sent to your email:
    radanet login --email you@example.com
  3. Optional, on a desktop: install the tray app, then open Rada from your applications.
    curl -fLO https://get.radanet.io/0.1.0/Rada_0.1.0_amd64.deb
    sudo apt install ./Rada_0.1.0_amd64.deb

Check it's working

radanet status

You should see state running, your name and address, dns rada.internal, filter on, and a list of machines with their path: direct or relay.

End-to-end test plan

Do these together, one person on a Mac and one on Linux. Replace FRIEND with the other person's machine name from radanet status or the menu bar window.

#TestHowExpected
1See each otherBoth run radanet statusEach lists the other as online
2Reach by nameping FRIENDReplies. The short name and FRIEND.rada.internal both work
3Direct or relayLook at the path column in radanet statusUsually direct; relay 3 (ws) on strict networks. Both work
4Share a web pageOne runs python3 -m http.server 8000; the other opens http://FRIEND:8000The file list loads in the browser
5SSH and copy a fileTurn on SSH (below), then ssh you@FRIEND and scp bigfile you@FRIEND:Logs in; a 50 MB file copies without stalling
6Change networksKeep ping FRIEND running and switch to a phone hotspotA few lost replies, then it recovers within about 40 seconds
7Pause and resumeToggle Connected in the menu bar, or radanet prefs --running false then trueThe other person sees you go offline, then online again
8Sign out and inMenu bar settings, or radanet logout then radanet login --email ...You get the same name and address back
9RestartReboot your machineRada reconnects by itself without signing in again

Turning on SSH for test 5. On Mac: System Settings > General > Sharing > Remote Login. On Ubuntu: sudo apt install openssh-server.

About access rules. Testers can reach each other freely. Ganesh's own machines are not open to testers, so trying to reach them is expected to fail.

If something goes wrong

Please send Ganesh what you were doing, what you expected, what happened, and these outputs:

radanet status
radanet logs

Full logs: macOS /var/log/radanet.log; Linux journalctl -u radanet --since "1 hour ago". If small transfers work but big ones stall, try radanet prefs --mtu 1200 and mention it in your report.

Things you could do with it

How Rada compares with Tailscale

Tailscale is the best-known product of this kind, and Rada works on the same principles: WireGuard, a coordination server, NAT traversal and relays. Tailscale is mature and covers far more. Rada is aimed at fleets of machines such as vehicles, robots and edge devices, and at teams that want to run the whole system themselves.

Rada 0.1 (this test)Tailscale
EncryptionWireGuard, end to endWireGuard, end to end
Through NAT and firewallsDirect paths, relay over HTTPS 443 as fallbackDirect paths, DERP relays over HTTPS
NamesPrivate DNS: name, name.rada.internalMagicDNS
Access rulesTags, direction and ports, enforced on each machineACLs and grants, users, groups, tags, ports
Signing inEmail code; one-time keys for machinesGoogle, Microsoft, GitHub, Okta and more; auth keys
PlatformsmacOS, LinuxmacOS, Windows, Linux, iOS, Android, more
Self-hostingYes: one small server program and a relayHosted service; Headscale is a separate community project
Machines without a personFirst-class: fleet keys, tags, a small agentSupported with auth keys and tags
Exit nodes, subnet routesNot yetYes
File sharing, SSH helper, public sharingNot yetTaildrop, Tailscale SSH, Funnel
Signed apps, app storesNot yet (this build is unsigned)Yes

Known limitations of this build

What gets installed, and how to remove it

macOSLinux
Background service/usr/local/bin/radanet, launch daemon io.radanet.agent/usr/bin/radanet, systemd unit radanet
App/Applications/Rada.appradanet-desktop (optional package)
Machine identity and settings/var/lib/radanet/var/lib/radanet
Network changesA utun interface for 100.96.0.0/16; DNS only for rada.internalA tun0 interface for 100.96.0.0/16; DNS only for rada.internal
Removesudo "/Library/Application Support/Rada/uninstall.sh" --purgesudo apt purge rada radanet

Your normal internet traffic and DNS are not touched. Only traffic for 100.96.x.x addresses and rada.internal names goes through Rada.