HOSTED BY
TRACK PARTNER
THE AGENT ARENA HACKATHON · SEP 26–27 · SAN FRANCISCO
How hackathon teams use NetBird: peer-to-peer WireGuard networking, a built-in reverse proxy, and one-command sharing with netbird expose.
Brandon Hopkins · Head of Content and Developer Relations, NetBird
THE PROBLEM
Agent code, the demo UI and local tools
Agent backends and tool servers
A teammate's machine serving a model
A Docker stack or a subnet with no way in
The quick fixes are public IPs, open ports and shared SSH keys. Each one widens what an agent, or anyone scanning the internet, can reach.
The Agent Arena Hackathon · San Francisco
WHAT NETBIRD IS
Install the client on any machine and sign in. It joins your private network with its own 100.x address.
From there it can reach any peer your policies allow, from any network, behind any NAT.
Direct WireGuard tunnels between machines, with NAT traversal and an encrypted relay as fallback.
Sign in with SSO and MFA. Groups and policies replace IP allowlists.
Linux, macOS, Windows, iOS, Android, Docker and Kubernetes.
Use NetBird Cloud, or run the whole control plane yourself.
The Agent Arena Hackathon · San Francisco
PEER-TO-PEER CONNECTIVITY
Management
Signal
STUN
Relay
Identity provider
(e.g., Okta)
Peer A
netbird
agent
Peer B
netbird
agent
managed or
self-hosted
auth
control
channel
control
channel
point-to-point WireGuard connection
The Agent Arena Hackathon · San Francisco
The Agent Arena Hackathon · San Francisco
IN YOUR PROJECT
Run tools on your laptop and let an agent on a Vultr VM call them at a private NetBird address.
Postgres, Redis or a vector store never gets a public IP. Only allowed peers connect.
Give agents their own group and allow only the hosts and ports they need.
REVERSE PROXY · CLOUD (BETA) AND SELF-HOSTED
THE INTERNET
Plain HTTPS, no client to install
HTTPS
NETBIRD PROXY
Certificates issued for you
WireGuard
YOUR PEER
No public IP, no open ports
SSO / OIDC
Password
6-digit PIN
API key header
NetBird peers only
IP and country rules
CrowdSec reputation
The Agent Arena Hackathon · San Francisco
NETBIRD EXPOSE · v0.66 AND LATER
$ netbird expose 3000 --with-name-prefix demo
→ https://demo-a1b2c3.proxy.example.com
--with-pin
--with-password
--with-user-groups
--protocol tcp | udp | tls
--with-external-port
--with-custom-domain
The URL lives only while the command runs. No cleanup, no forgotten tunnels.
An admin enables Peer Expose in account settings first. Up to 10 active sessions per peer.
The Agent Arena Hackathon · San Francisco
🔐 BONUS · ADD-ON TO CHALLENGE 1 OR 2
Serve your project through the NetBird reverse proxy instead of opening ports on your Vultr VM, and earn bonus points on top of your challenge score.
1
Your public demo URL is served through NetBird, with no inbound application ports on the VM.
2
The service sits behind SSO, password, PIN or header auth, matched to a real user role.
3
Demo the connectivity: machines on your NetBird network reaching each other directly over WireGuard.
The Agent Arena Hackathon · San Francisco
DEPLOYMENT
OPTION 1 · FASTEST
Free for up to 5 users and 100 machines. Nothing to host.
OPTION 2 · FULL CONTROL
A one-click Marketplace app on your own server and domain.
OPTION 1 · NETBIRD CLOUD
$0
for up to 5 users and 100 machines
INCLUDED ON THE FREE PLAN
1
app.netbird.io
2
curl -fsSL https://pkgs.netbird.io/install.sh | sh
3
netbird up
macOS, Windows, iOS and Android installers: docs.netbird.io
The Agent Arena Hackathon · San Francisco
OPTION 2 · SELF-HOSTED
1
Shared CPU with at least 2 GB of memory. Under Marketplace Apps, search for NetBird.
2
The email is for Let's Encrypt. The domain is where NetBird lives, like netbird.example.com.
3
A · netbird → your server IP
CNAME · *.netbird → netbird.example.com
4
When the console prints “NetBird setup is complete”, open your domain in a browser.
WHAT THE IMAGE RUNS
The Agent Arena Hackathon · San Francisco
Free on NetBird Cloud, or yours on Vultr. Either way, your whole stack is one private network.
Questions this weekend? Find Brandon Hopkins, or reach out at community@netbird.io.
NETBIRD CLOUD, FREE
app.netbird.io
DOCS
docs.netbird.io
SOURCE
github.com/netbirdio/netbird
VULTR MARKETPLACE · SEARCH NETBIRD
vultr.com/marketplace