Install with AI
Let your AI coding agent set this up. Copy the one-liner below and paste it into your agent.
Set up WireZTNA for me: fetch and follow https://wireztna.com/docs/quickstart/agent-setup.md
Works with Claude Code, Cursor, Codex and more.
Prerequisites
- • Either: a self-hosted broker you deploy (open source), or a managed SaaS/partner account.
- • A Linux machine on your client's network for the publisher (any VM, bare metal, or cloud instance)
- • A workstation (macOS, Windows, or Linux) for the client
Self-host it yourself (Open Source)
Deploy your own broker on a host with a public IP. You run it, no partner account needed.
We operate itLet us run it (Managed SaaS)
Use your partner account and your your-tenant.wireztna.com tenant. We host the broker.
Self-host it yourself (Open Source)
Run your own broker. Everything in Path B then works the same — just use your own broker hostname wherever these steps show your-tenant.wireztna.com.
-
1. Provision a host with a public IP
Any Linux VM or bare-metal server reachable from the internet (a single small instance is enough to start).
-
2. Install the broker
Follow the open-source install from the repository at github.com/wireztna/wireztna-oss.
-
3. Create the first admin
Create your initial admin account and open the admin panel on your own broker hostname.
-
4. Continue with publisher install + client enroll
Follow Steps 1–3 below, substituting your own broker hostname for
your-tenant.wireztna.comin every command.
Let us run it (Managed SaaS)
Using your partner account and your-tenant.wireztna.com tenant, follow the steps below. (Self-hosters: these same steps apply — use your own broker hostname.)
Install the Publisher
In the admin panel, go to Publishers and click "+ Add Publisher". This generates a one-time enrollment token and shows you a one-liner command.
SSH into your client's Linux machine and run the command:
curl -fsSL https://your-tenant.wireztna.com/api/v1/publishers/install.sh | sudo bash
This downloads the publisher binary (8 MB), enrolls it with the broker using the embedded token, creates a WireGuard tunnel, and installs a systemd service. Takes ~10 seconds.
What happens under the hood:
- Downloads
wireztna-publisherstatic binary - Generates a WireGuard keypair locally (private key never leaves the machine)
- Registers with the broker via the enrollment token
- Establishes a persistent WireGuard tunnel to the broker
- Installs as a systemd service (auto-starts on boot)
Create a User and Generate Enrollment Token
In the admin panel:
- Go to Users → + New User — enter the user's email
- Go to Groups — assign the user to a group that has access to the publisher
- Click the user → Enrollment tab → Generate Token
- Copy the enrollment URL and send it to the user
The enrollment URL looks like: https://your-tenant.wireztna.com/api/v1/clients/enroll?token=abc123...
Tokens are one-time use, expire in 24h, and can be revoked from the admin panel.
Enroll and Connect the Client
On the user's workstation, run these three commands:
Enroll (registers the device with the broker):
wireztna enroll "https://your-tenant.wireztna.com/api/v1/clients/enroll?token=abc123"
Login (authenticates the user):
wireztna login
Connect (establishes the tunnel):
sudo wireztna connect
On Windows, use an elevated PowerShell instead of sudo. On macOS/Linux, sudo is needed for creating the network interface.
Verify Connectivity
Once connected, the client can reach resources on the publisher's network:
# Ping a host on the publisher's LAN
ping 10.50.1.100
# Access a service
curl http://10.50.1.100:8080
# Check tunnel status
wireztna status
The client only has access to the CIDRs exposed by publishers in their assigned groups. All other traffic stays on the user's default network (split tunnel).