Quick Start Guide
Get up and running with Xelon HQ in five steps. From your first login to launching your first virtual machine.
Xelon HQ is your cloud management platform for deploying and managing virtual infrastructure. This guide walks you through the essentials so you can start building in minutes.
Log in to Xelon HQ
Open your browser and navigate to hq.xelon.ch. Enter the email address and password provided by your organization administrator. If your organization uses single sign-on (SSO), select the appropriate identity provider on the login screen.
Enable two-factor authentication (2FA) on your account for an additional layer of security. You can configure this from your user profile (click your avatar in the top-right corner) after logging in.
Explore the Dashboard
After logging in, you land on the dashboard. The dashboard provides an at-a-glance overview of your infrastructure with the following widgets:
- Quick Actions — Shortcuts to common tasks: Create VM, Create Network, Create Load Balancer, Create Firewall, View Logs, Read Docs, and Request Feature.
- Resource Cost Distribution — A chart showing cost breakdown by resource type. Visible to users with the
allow_view_usage_reportspermission. - Pinned Devices — Pin frequently used devices for quick access. Click + Pin device, select an organization, select a device, and click Pin. Each pinned device shows its name, power status (ON/OFF), and a console button. Use Unpin mode to remove pinned devices.
- Backup Protection — Shows the count of Protected vs Unprotected devices and the last backup date. Visible to users with the
allow_manage_virtual_machine_backupspermission. - Active Subtenants — A carousel of sub-organizations displaying VM count, user count, and network count for each. Visible to users with the
allow_view_organizationspermission. - Margin Comparison — A cost comparison table showing "What you pay" vs "What customer pays" with the calculated margin. Only available for reseller organizations and requires the
allow_view_usage_reportspermission. - Events Log — A feed of recent activity across your infrastructure.
You can switch between the new dashboard and the classic dashboard via a link at the top of the page.
Navigate the Sidebar
The left sidebar is your primary navigation tool. It is organized into the following sections:
| Section | Description |
|---|---|
| Virtual Datacenter | All Devices, Disaster Recovery, Templates & ISOs, Networking (with sub-tabs for All Networks, DNS Zones, Firewalls, Load Balancer, WAF), and S3 Object Storage. |
| Kubernetes | Xelon Kubernetes Service (XKS) cluster management. |
| Billing & Reports | Billing Details (invoices, payment methods, credits, billing plans) and Usage Reports. |
The sidebar sections visible to you depend on your assigned permissions. If a section is missing, contact your organization administrator to request access.
Create Your First Organization
Organizations (referred to as tenants in the system) are the top-level containers for all your resources. Every virtual machine, network, and billing record belongs to an organization.
- Navigate to Manage All Organizations in the sidebar.
- Click Create Organization.
- Fill in the organization name, address, and billing contact details.
- Click Save to create the organization.
Once created, you can invite users and assign permissions. See the Organizations guide for full details on managing tenants.
Create Your First Virtual Machine
With an organization in place, you are ready to deploy your first VM:
- Go to Virtual Datacenter > All Devices in the sidebar.
- Click Create Device (or use the Create Device link on the dashboard).
- Select an operating system template (e.g., Ubuntu, Windows Server).
- Configure hardware: choose CPU cores, RAM, and disk size and type.
- Select a network and optionally attach an SSH key for secure access.
- Review the configuration summary and click Create.
Your VM will be provisioned within moments. For comprehensive VM management options, see the Virtual Machines documentation.
Next Steps
Now that you have your first organization and VM, explore these topics to get the most out of Xelon HQ:
- Organizations — Learn about sub-organizations, user management, and reseller structures.
- Roles & Permissions — Configure role-based access control for your team.
- Snapshots — Protect your VMs with point-in-time snapshots.
- Networking — Set up networks, firewalls, and load balancers.