Quick Start Guide

Get up and running with Xelon HQ in five steps. From your first login to launching your first virtual machine.

Welcome to Xelon HQ

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.

Tip

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:

  1. Quick Actions — Shortcuts to common tasks: Create VM, Create Network, Create Load Balancer, Create Firewall, View Logs, Read Docs, and Request Feature.
  2. Resource Cost Distribution — A chart showing cost breakdown by resource type. Visible to users with the allow_view_usage_reports permission.
  3. 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.
  4. Backup Protection — Shows the count of Protected vs Unprotected devices and the last backup date. Visible to users with the allow_manage_virtual_machine_backups permission.
  5. Active Subtenants — A carousel of sub-organizations displaying VM count, user count, and network count for each. Visible to users with the allow_view_organizations permission.
  6. 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_reports permission.
  7. Events Log — A feed of recent activity across your infrastructure.
Tip

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.
Tip

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.

  1. Navigate to Manage All Organizations in the sidebar.
  2. Click Create Organization.
  3. Fill in the organization name, address, and billing contact details.
  4. 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:

  1. Go to Virtual Datacenter > All Devices in the sidebar.
  2. Click Create Device (or use the Create Device link on the dashboard).
  3. Select an operating system template (e.g., Ubuntu, Windows Server).
  4. Configure hardware: choose CPU cores, RAM, and disk size and type.
  5. Select a network and optionally attach an SSH key for secure access.
  6. 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.