First-Time Setup: A Simple Walkthrough
From a brand-new appliance to one working connection, in twelve steps.
Naming: this article uses the current product names - Gateway (formerly CSG) and Manager (formerly XCM). Screens are from v5.6.1.
Contents
- Appliance Console - Log in and change the console password
- Appliance Console - Note the Recovery Key and Installation ID
- Appliance Console - Set the IP addresses
- Appliance Console - Set a gateway on one interface only
- Appliance Console - Turn on time sync
- Web interface - Log in and change the web password
- Web interface - Install your license
- Web interface - Certificate: install one, or leave it for later
- Web interface - Join the Manager (skip if you have none)
- Web interface - Create a user
- Web interface - Create a connection
- Web interface - Give the user access, then test as them
Before you start
- ☐ Two network ports and two IP addresses on different subnets (one of each for a single-interface setup)
- ☐ A power outlet (not needed for a VM)
- ☐ A computer that can reach the appliance
Ask for these firewall openings early - they are the most common delay.
| Open | Why |
|---|---|
| TCP 443 to the Untrusted IP, from your users | Users reach the login page |
| UDP 39251 from the Gateway to the Manager | Only if you have a Manager |
ℹ Set up one appliance at a time
Every appliance ships with the same default IP addresses. If you have a Manager, set it up first.
Two separate logins
How it fits together. The Appliance Console is a text menu used for network settings, while the web interface is used for licensing, users and connections.
Both start as
admin/admin. Changing one does not change the other.
Part 1 - In the Appliance Console
1. Appliance Console - Log in and change the console password
Press ENTER. Press TAB to highlight I Agree, then ENTER. At Enter Password, type admin.



Choose Yes to change the password. Enter admin, then your new password twice. It needs 15+ characters with upper and lower case, a number, and a symbol.



⛔ Save this password now
On a Manager there is no way to reset it. A lost console password means rebuilding the appliance.
2. Appliance Console - Note the Recovery Key and Installation ID
In the main menu, press ENTER on About Appliance.


Save the Recovery Key somewhere safe - XONA does not keep a copy. On a VM it shows not applicable, which is normal.
Note the Installation ID. You need it for your license in step 7. If it is blank, reboot the appliance.
⚠ Physical appliance? Never pull the power
Always shut down from the menu. Hard power cuts can make it ask for the Recovery Key.
3. Appliance Console - Set the IP addresses
Go to Network Configuration and open Configure Untrusted, then Configure Trusted. Replace each address, then TAB down to OK and press ENTER.


Untrusted faces your users (and the Manager). Trusted faces the equipment. Put them on different subnets.
ℹ Using only one interface?
That works on a Gateway and a Manager. Most people keep Trusted. On the unused one, clear its address, turn off IPv4 and IPv6, and uncheck Automatically connect. Everything, including the Manager link, then uses the one interface.
4. Appliance Console - Set a gateway on one interface only
Fill in Gateway and DNS servers on one interface (screenshot in step 3). On the other, leave Gateway empty and tick Never use this network for default route.

Changes apply when you press OK. Check Network Tools → Show Network: there should be only one default via line.

5. Appliance Console - Turn on time sync
In Network Configuration → Set Time Servers, keep the default servers if the appliance has internet access. Otherwise enter one it can reach. The menu should show Timesync Status: enabled.


Later, in the web interface, Settings → Appliance → Date / Time should show Active.

⚠ Do not skip this
A wrong clock breaks MFA codes, single sign-on and the Manager link.
Part 2 - In the web interface
In a browser, go to https:// plus the IP address you set. The warning below is expected on a new appliance - continue past it.

6. Web interface - Log in and change the web password
Log in with admin / admin, then set a new password (12+ characters). Log in again with it.



This is separate from the console password. Save it too.
7. Web interface - Install your license
Send your Installation ID (shown here as System UUID) to XONA. Upload the license file you get back with Choose File and Upload License.

Each appliance needs its own license.
Until then, the evaluation license allows 2 connections. The built-in Appliance Setup connection uses one, so you can add one more - enough for this guide.
8. Web interface - Certificate: install one, or leave it for later
The appliance starts with a self-signed certificate. That is why your browser warns you. It is fine for setup.
Before real users arrive, give the appliance a DNS name and upload a proper certificate in Settings → Security → Certificates. The SSL Certificate Setup Guide covers this.

9. Web interface - Join the Manager (skip if you have none)
Join each Gateway to the Manager before creating users and connections. On the Gateway, go to Settings → Fabric. The Joining a Gateway to the Manager guide has the exact steps.

⚠ Needs UDP 39251
The Gateway reaches the Manager only on UDP 39251. Ping working proves nothing. Ask for a firewall UDP timeout of 60 seconds or more.
Updating software? Do the Manager first. Setting up high availability? Do it last.
10. Web interface - Create a user
Go to Users → Add a User and enter a Username. A first password is generated. The user changes it at first login.


Have a Manager? Create users on the Manager. They log in to a Gateway as MGR\username.
11. Web interface - Create a connection
Go to Connections → Add a Connection. Pick the type, enter a name and the equipment's address.


Press Test TCP to Host, then Submit.


12. Web interface - Give the user access, then test as them
Open the connection's Permissions tab. Press Assign to User, pick the user, turn on Connect without Approval, and press Apply. No one has access until you do this.


Log in as that user (a private window works) and open the connection.


RDP says Authentication Failed? Save Windows credentials in the connection, or turn on Manual Login so users enter their own.
✓ Last step: take a backup
Go to Settings → Appliance → Backup/Restore and press Download Backup. Keep the file somewhere safe.

Checklist
- ☐ Firewall: TCP 443 to the appliance, UDP 39251 to the Manager (if any)
- ☐ Console password changed and saved
- ☐ Recovery Key and Installation ID saved
- ☐ IP addresses set; only one interface has a gateway
- ☐ Time sync Active
- ☐ Web password changed and saved
- ☐ License uploaded
- ☐ Gateway Connected on the Manager (if any)
- ☐ A real user connected (not admin)
- ☐ Backup downloaded
If something is not working
| Problem | Check |
|---|---|
| Web page will not load | Steps 3 and 4, and that TCP 443 is open |
| Login or MFA codes rejected | Step 5 - the clock |
| Gateway stuck on Pending on the Manager | Step 9 - UDP 39251 |
ℹ Still stuck?
Contact XONA Customer Success and tell them which step you reached.