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

# HestiaCP

> Order a VPS with HestiaCP, retrieve the generated credentials and add your first site

[HestiaCP](https://hestiacp.com) is a lightweight open source web hosting panel published by a third party. It manages sites, email, databases and DNS, asks little of the server, and costs nothing in licences. On an OnetSolutions VPS, it is installed for you when the server is created.

<Info>
  **Prerequisites**

  * A plan with at least 1 vCPU, 2 GB of RAM and 20 GB of storage
  * No licence: HestiaCP is free and open source
</Info>

## Order

<Steps>
  <Step title="Pick the plan">
    Pick a plan on the [HestiaCP VPS](https://onetsolutions.net/en/vps/hestiacp) page: HestiaCP is already selected in the order.
  </Step>

  <Step title="Check the installation">
    At the **What do you want to install?** step, HestiaCP is shown on its own. Debian 13 is chosen automatically.
  </Step>

  <Step title="Order">
    The server is created, then HestiaCP installs itself in ten to twenty minutes.
  </Step>
</Steps>

You can also install HestiaCP on an existing VPS by [reinstalling it](/control-panels/overview#install-a-panel-on-an-existing-vps).

## First sign-in

HestiaCP generates its own administrator credentials during the installation, rather than letting you create the first account from the browser.

<Steps>
  <Step title="Read the credentials">
    On your instance page, the control panel card has a **Show credentials** button: it reads the username and password that the installation wrote on your server.
  </Step>

  <Step title="Open the panel">
    Select **Open the panel**, or open `https://<server IP address>:8083`. Your browser warns about a self-signed certificate until a domain name is configured: this is expected.
  </Step>

  <Step title="Change the password">
    Change the administrator password at your first login.
  </Step>
</Steps>

<Note>
  The credentials also stay on the server, in `/root/hestiacp-admin.txt`, readable over SSH.
</Note>

## Firewall

If you enable your VPS [firewall](/vps/firewall), allow port 8083 for the panel, 80 and 443 for your sites, and the email ports if you host mailboxes. The [HestiaCP documentation](https://hestiacp.com/docs) lists the full set.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The installation shows Failed">
    Contact [support](/console/support) from the console: we will help you run the installation again. The installation details are logged on the server, in `/var/log/onetsolutions-hestiacp-install.log`.
  </Accordion>

  <Accordion title="Show credentials returns nothing">
    The button reads the file on the server once the installation has finished. Wait for the card to show **Installed**, then try again.
  </Accordion>

  <Accordion title="The panel does not answer on port 8083">
    Check that the card status is **Installed**, then that port 8083 is allowed if the firewall is enabled.
  </Accordion>
</AccordionGroup>
