§Guide
Host an Onset server.
Install it, invite people, open one port.
Onset Host is the free server behind Onset Voice. This guide sets it up on a Windows PC, first for people on your own network, then for friends anywhere over the internet. You need no domain name, no certificate and no paid hosting.
- What you need
- 1. Install Onset Host
- 2. Create the owner account
- 3. Invite people on your network
- 4. Open it to the internet
- Forward the port by hand
- Check it from outside
- No public IPv4 address (CGNAT)
- Troubleshooting
- Keep it running
What you need
- A Windows 10 or 11 PC (64-bit) that stays on while people use the server, and an administrator account to install it.
- The Onset app, 1.0.5 or later, on every PC that connects, yours included; 1.0.9 or later for end-to-end encrypted calls. Get it from the download section or as Onset Voice on the Microsoft Store.
- For friends outside your home: a public IPv4 address, and a router with UPnP or one where you can forward a port. If your provider uses carrier-grade NAT, you can host only on your own network; see No public IPv4 address.
1. Install Onset Host
- Download
Onset-Host-<version>-x64.msifrom the download section. The GitHub release also has aSHA256SUMSfile to check it against. - Run the installer and approve the administrator prompt. It is not signed with a paid code-signing certificate, so SmartScreen may say Windows protected your PC. To be sure the file is the published one, run
Get-FileHash .\Onset-Host-<version>-x64.msi -Algorithm SHA256in PowerShell and compare the result with its line inSHA256SUMS. Then choose More info and Run anyway. - The installer puts the server in
C:\Program Files\Onset Host, adds Onset Host shortcuts to the desktop and Start menu, and lets devices on your local network through Windows Firewall. From version 1.0.5 it also sets up the Onset Host Update service, so this is the last time you install Onset Host by hand.
2. Create the owner account
- Open the Onset Host shortcut. It starts the server in the background and opens the control panel in your browser at
http://127.0.0.1:9090. Only this PC can open the panel. The server starts in LAN mode, with invite-only registration and message history kept until people delete it. - On the panel’s Overview, click Copy invite. Paste the invite into the Onset app’s Server address.
- Choose Register a new account, and paste the Owner setup token from the panel’s Access page into Bootstrap token. The first account becomes the server’s owner, who can make other people admins or moderators later.
An invite looks like 192.168.1.20:8080# followed by 64 characters. Those characters are the server’s identity fingerprint: the app connects only to a server with exactly that identity, so nobody can quietly stand in for yours, not even on the first connection.
3. Invite people on your network
Send each person the invite and the invite token, both from the panel’s Overview. They paste the invite into Server address, choose Register a new account and paste the invite token into Bootstrap token. Under Access → Sign-ups you can instead close the server to new accounts, or open it to anyone who can reach it.
If someone on your network cannot connect, check that the server PC’s network profile is Private (Settings → Network & internet → your connection → Network profile type). The installer’s firewall rule does not apply on Public networks.
4. Open it to the internet
On the panel’s Connection page, choose Internet and Save. The server restarts, and the first time Windows asks for administrator approval to accept connections from outside your local network. The panel then shows your public address and a new invite. Send that invite to people outside your home; people at home can keep using the LAN one.
With Set up my router automatically on, which is the default, there is nothing else to do: the server finds your public address and opens its port on the router. The mapping lasts an hour and is renewed every 20 minutes while the server runs. It never takes over a mapping that belongs to another device; the panel tells you if one is in the way.
Everything goes through one port: sign-in, chat, files, voice and screen sharing.
| Port | What it carries | Forward it? |
|---|---|---|
UDP 8080 | Everything the app does: control over QUIC, encrypted voice, screen sharing | Yes |
TCP 8080 | The panel’s own calls, and telling apps older than 1.0.5 to update | Optional |
TCP 9090 | The control panel, on this PC only | Never |
8080 is the default. You can choose another number in the panel’s Port setting, on the Connection page; the invite always names the right one.
Forward the port by hand
If your router has no UPnP, or the panel says The server could not start: the router is not set up, open the port yourself:
- On the panel’s Connection page, turn off Set up my router automatically and Save.
- Find the server PC’s local address: run
ipconfigand note the IPv4 Address of the connection you use, such as192.168.1.20. - Make the address stay the same. In the router’s settings this is usually called a DHCP reservation or a static lease. Otherwise the PC can get a new address after a restart, and the forward points at nothing.
- Open the router’s admin page (often
192.168.1.1or192.168.0.1) and find port forwarding. Some routers call it virtual servers or NAT. Add a rule for protocol UDP, external and internal port 8080, to the PC’s local address. - Behind two routers, such as your provider’s modem and your own router, forward the port on both: on the modem to your router, and on your router to the PC.
- Leave Public IPv4 address in the panel empty. The server finds your public address by itself: it asks onsetvoice.com which address the request came from, when it starts and every ten minutes, and sends nothing else. If the address changes, screen sharing follows it without a restart.
Forwarding TCP 8080 as well is harmless: someone with an outdated app then sees a message to update instead of a failed connection. Onset needs no other port, not port 80, and no certificate from anyone.
Check it from outside
Test from a different network, such as a laptop on your phone’s hotspot, or ask a friend to connect. Many routers don’t loop a connection to their own public address back into the home network, so connecting with the internet invite from home can fail even when everything is set up right.
No public IPv4 address (CGNAT)
Some providers share one public address among many customers. This is called carrier-grade NAT, and behind it nobody outside can reach your PC directly. The Router row on the panel’s Connection page says CGNAT or private upstream address. You can also look at the internet (WAN) address on your router’s status page: if it starts with 10., 192.168. or 172.16. to 172.31., or falls in 100.64.0.0/10, there is another NAT between you and the internet.
Ask your provider for a public IPv4 address, or use LAN mode. Onset doesn’t include a relay service.
Troubleshooting
“The server could not start: the router is not set up”
The Router row on the panel’s Connection page says why. Automatic mapping unavailable means no router answered UPnP: turn on UPnP in the router’s settings, or forward the port by hand. Behind another router means UPnP can open the port only on the inner router: forward it by hand on both. Automatic mapping failed means the router refused; its answer is in the server log, and forwarding by hand works around it.
“… is already mapped by another application”
Another device or program already holds that port on your router. Choose a different port in the panel, or remove the old mapping in the router’s settings.
The app says the server “answered over TCP only” or “needs UDP port 8080”
Only the TCP port answered. Forward the port for UDP, not just TCP, to the PC’s local address, on both routers if there are two. A network that blocks UDP altogether, as some workplace networks do, cannot reach the server.
People outside my network can’t see screen shares
Use Internet mode for them. In LAN mode the server offers only its local address for screen sharing.
“This server’s identity changed”
The server has a new identity, usually because it was reinstalled or its certificates folder was deleted without restoring a backup. Restore certificates from your latest backup and restart. If you really started over, send everyone the new invite so they can compare fingerprints before choosing Trust the new identity.
Start fails with “Windows firewall setup needs administrator approval”
Internet mode needs a firewall rule, and the approval prompt was declined. Choose Start server again and approve it, or switch back to This network.
Keep it running
- Start with Windows in the panel starts the server in the background when you sign in. If the server process stops unexpectedly, the panel restarts it.
- Backups run every day at 04:00 by default and keep the newest 14. They are encrypted and taken from a live snapshot, so calls keep running. After the first one, export a recovery key, or only your Windows account on this PC can open them:
& "$env:ProgramFiles\Onset Host\onset-host.exe" --export-backup-key 'E:\onset-recovery.key'. Keep the key away from the backups, and point the backup folder at another drive. - Updates. From version 1.0.5, Onset Host updates itself. It looks for a new release every six hours, checks its signature, and installs it without an administrator prompt. With Install updates automatically on, the default, that happens only after nobody has been in a voice room for 10 minutes; the server restarts and the apps reconnect on their own. Install now on the Updates page installs at once. To move to 1.0.5 from an earlier version, make a backup and run the new installer once; it keeps your data, identity and settings. The release notes say which app each server version works with.
- Encrypted calls. On the Calls page, On (the default) encrypts calls end to end whenever everyone in them has Onset 1.0.9 or later. Required keeps older apps out of voice rooms until they update; Off is for when encrypted calls cause problems. Chat and files are not part of this.
Every setting, the restore steps and the security details are in the Onset Host reference on GitHub. Stuck? Email support@onsetvoice.com with your Onset Host version and the relevant lines of the panel’s Server log.