> ## Documentation Index
> Fetch the complete documentation index at: https://doc.qbilon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Qbilon Suite Installer

> Follow the Qbilon Suite installer for Qbilon Monitoring and Qbilon Core.

## Preface

Welcome! This guide will walk you through the process of installing **Qbilon Suite** on your Windows or Linux machine.
**Qbilon Suite** consists of **Qbilon Monitoring** and **Qbilon Core.** Follow each step carefully to ensure a smooth setup process.

## Before You Begin

* For **Qbilon Monitoring** make sure your setup fulfills [the requirements](https://www.paessler.com/prtg/system-requirements).
* For **Qbilon Core** please make sure you have [everything needed for a successful installation](https://doc.qbilon.io/02-on-prem-setup/index).

## Step 1: Installation Start

When you launch the Qbilon Suite setup, you'll see the initial screen asking if you want to install Qbilon Monitoring.

**What you'll see:**

* Question: "Do you want to install Qbilon Monitoring?"
* Note: `Skip` will directly bring you to the **Qbilon Core** installation.

**What to do:**

* Click `Install` if you want to set up monitoring capabilities first (recommended).
* Click `Skip` if you only need Qbilon Core and want to skip the monitoring component.

> [!NOTE]
>
> Install Qbilon Monitoring first to get comprehensive visibility into your system from the start.

## Step 2: Installation Settings

After choosing to install Qbilon Monitoring, you'll configure basic settings.

**Language Selection**

* **Field:** Language dropdown
* **What to enter:** Select your preferred language for the installation interface.

**Auto-discovery Option**

* **Field:** Toggle switch for `Perform initial auto-discovery after installation`
* **What it means:** When enabled, Qbilon will automatically scan and discover devices on your network after installation completes.

**E-mail Configuration**

* **Field:** E-Mail
* **What to enter:** The e-mail address that will receive notifications from Qbilon Monitoring
* **Example:** `admin@yourcompany.com`
* **Note:** Make sure this is a monitored email address, as you'll receive important system alerts here

**What to do:**

* Fill in all fields
* Click `Next` to continue

## Step 3: License Agreement

You'll need to accept the Qbilon license terms to proceed.

**What you'll see:**

* a text box with license agreement information
* a link to the full terms at [https://qbilon.io/terms](https://qbilon.io/terms)

**What to do:**

* Read the license agreement carefully.
* Click the link if you want to review the complete terms.
* Click `I Agree` to accept and continue.
* Click `Cancel` if you don't accept (this will exit the installation).

## Step 4: Download Progress

The installer will now download Qbilon Monitoring components.

**What to do:**

* Wait for the download to complete.
* Don't close the installer window.
* The `Next` button will remain disabled until download is complete.

**Duration:** This typically takes a few minutes depending on your internet connection.

## Step 5: Download Finished

Once the download completes, you'll see confirmation.

**What you'll see:**

* Progress bar at 100%
* Text: `Finished Download`

**What to do:** Nothing. Once downloaded the installation will start automatically.

## Step 6: Installation in Progress

The installer will now install Qbilon Monitoring on your system.

**What you'll see:**

* A progress bar showing the installation progress.
* Text: `Installing Qbilon Monitoring...`

**What to do:**

* Wait for the installation to complete.
* Do not interrupt this process.
* Keep your computer connected to power.

**Duration:** This step usually takes a few minutes.

## Step 7: Installation Finished - Qbilon Monitoring

Congratulations! Qbilon Monitoring has been successfully installed.

**What you'll see:**

* **Access URL:** `http://127.0.0.1/public/login.htm`
* **Default credentials:** username `prtgadmin` and password: `prtgadmin`.

**Important Security Steps:**

* Copy the access URL.
* Note down the credentials.
* **Change the default password immediately after first login** for security reasons.

**What to do:**

* Click `Next` to continue with Qbilon Core installation

> [!NOTE]
>
> Security Note: The default credentials are the same for all installations. Change them as soon as you log in for the first time.

## Step 8: Qbilon Core Installation Decision

Now you'll be asked if you want to install Qbilon Core.

**What to do:**

* Click `Next` if you want to install Qbilon Core (recommended for complete functionality)
* Click `Cancel` if you only need Qbilon Monitoring

## Step 9: Qbilon Core Installation Settings

This is where you configure how Qbilon Core connects to your Linux server.

**Hostname/IP**

* The hostname or IP address of your Linux machine where Qbilon Core will be installed
* **Examples:**
  * `192.168.1.100` (IP address)
  * `server.yourcompany.local` (hostname)
  * `qbilon-prod-01` (hostname)

**Username**
A user account on the Linux server that has sufficient privileges to install software

**Examples:**

* `root` (if using root account)
* `ubuntu` (common on Ubuntu systems)
* Your admin username

> [!NOTE]
>
> This user needs sudo/root privileges to complete the installation.

**Path to Certificate**

* The full path to your SSH certificate file for authentication
* **Examples:**
  * `/home/user/.ssh/id_rsa`
  * `C:\Users\YourName\.ssh\qbilon_key`
  * `/Users/yourname/.ssh/server_key.pem`

> [!NOTE]
>
> This is used for secure, key-based authentication instead of password authentication. If you don't have a certificate, you may need to set up SSH key authentication first.

**Domain**
The domain under which Qbilon Core should be accessible

**Examples:**

* `qbilon.yourcompany.com`
* `monitoring.example.org`
* **Note:** Make sure this domain is configured in your DNS and points to your server's IP address. Direct usage of an IP Address without a domain is **not** supported.

**Redirect URL**

* The redirect URL for Qbilon Core after login
* **Example:** `https://acme.org`

**What to do:**

1. Fill in all required fields carefully.
2. Double-check your entries, especially the hostname/IP and certificate path.
3. Click **"Install"** to begin Qbilon Core installation.

## Step 10: Qbilon Core Installation in Progress

The installer will now install Qbilon Core on your Linux server.

**What to do:**

* Wait patiently for the installation to complete.
* Do not close the installer or interrupt the SSH connection.
* Ensure your network connection remains stable.

**Duration:** This step can take 10-20 minutes depending on your server's performance and network speed.

**What's happening behind the scenes:**

* connecting to your Linux server via SSH,
* installing dependencies,
* configuring Qbilon Core services,
* setting up database connections and
* configuring web server components.

## Step 11: Installation Finished - Qbilon Core

Congratulations! Your Qbilon Suite installation is complete.

**What you'll see:** A success message with your access information:

* **Access URL:** `https://<domain>` (your configured domain)
* Username: `admin`
* Password: an initial password

**Important Information:**

1. **Save your credentials immediately** - write them down or store them in a secure password manager.
2. Change the password for enhanced security.
3. You can access Qbilon Core through the displayed URL.

**What to do:**

* Copy and securely store your credentials.
* Copy the access URL.
* Click **"Finish"** to close the installer.

## Post-Installation Steps

Now that your installation is complete, here are your next steps:

**1. Access Qbilon Monitoring**

* Open your web browser.
* Navigate to: `http://127.0.0.1/public/login.htm`.
* Log in with:
  * Username: `prtgadmin`
  * Password: `prtgadmin`
* **Immediately change your password** in the settings.

**2. Access Qbilon Core**

* Open your web browser.
* Navigate to: `https://<your-domain>`.
* Log in with the credentials provided at the end of installation.
* Consider changing your password to something memorable (but still secure).

**3. Initial Configuration**

* Complete the initial setup wizard if prompted.
* Configure monitoring targets if auto-discovery is running.
* Review and adjust notification settings.
* Set up additional user accounts if needed.

## Support and Documentation

For additional help ...

* visit the official documentation at [www.qbilon.io/documentation](http://www.qbilon.io/documentation) or
* [contact support](mailto:support@qbilon.io) if you encounter persistent issues.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.