Hestia Control Panel

Current stable release: Version 1.1.1, released on March 26th, 2020.
Current development release: Version 1.2.0.

Due to a change of the repository infrastructure, please install the new key before you upgrade your existing installations:

wget -qO - https://gpg.hestiacp.com/deb_signing.key | sudo apt-key add -

Welcome!

Hestia Control Panel offers easy to use web and command line interfaces, enabling web server administrators to quickly deploy and manage web domains, mail accounts, and DNS zones from one central location without the hassle of manually deploying and configuring individual components.

While we have taken every effort to make the interface as friendly as possible (even for new users), it is assumed that you will have some prior knowledge and understanding in the basics how to set up a Linux server and managing web applications.

We cannot provide support for requests that do not describe in detail the troubleshooting that has already been performed, or for third-party applications which do not directly relate to Hestia Control Panel. Please make sure that you fill in the necessary details in your issue reports, and remove any sections that do not apply to your issue or use case.

Interested in helping shape the future of Hestia Control Panel?

Are you a software developer, tester, or have experience in writing documentation or guides and have some time to contibute to the project?

Please send an email to info@hestiacp.com with a quick outline of your previous experience in any of these areas or where you think you could help on the project and we'll reach out to discuss the next steps.

As always we welcome all feedback and contributions!

Sincerely,
The Hestia Control Panel development team

What is Hestia Control Panel?

An open source web server control panel with an easy-to-use interface.
A lightweight alternative to cPanel, Plesk, etc.

What does Hestia Control Panel support?

Standard Web Server (Apache/NGINX) with PHP
PHP Web Application Server (NGINX + PHP-FPM)
Multiple PHP versions (5.6 - 7.4, with 7.3 currently as default for optimal compatibility)
DNS Server (Bind) with clustering capabilities
Mail Server (Exim/Dovecot) with Anti-Virus and Anti-Spam (ClamAV and SpamAssassin)
Database functionality (MariaDB/PostgreSQL)
Let's Encrypt SSL with wildcard certificates

Supported operating systems:

Debian 8, 9, 10
Ubuntu 16.04 LTS or Ubuntu 18.04 LTS (the latest LTS release is generally recommended)
NOTE: Hestia Control Panel must be installed on top of a fresh operating system installation to ensure proper functionality.

Installing Hestia Control Panel

Step 1: Log in

To install Hestia Control Panel on your server, you will need to be logged in as root or a user with super-user privileges in order to continue. You can perform the installation either directly from the command line console or remotely via SSH:

ssh root@your.server

Step 2: Download

Download the installation script for the latest release:

wget https://raw.githubusercontent.com/hestiacp/hestiacp/release/install/hst-install.sh

If the download fails due to an SSL validation error, please be sure you've installed the ca-certificate package on your system - you can do this with the following command:

apt-get update && apt-get install ca-certificates

Step 3: Run

To begin the installation process, simply run the script and follow the on-screen prompts:

bash hst-install.sh

You will receive a welcome email at the address specified during installation (if applicable) and on-screen instructions after the installation is completed to log in and access your server.

Additional installation notes:

To perform an unattended installation using the default options:

bash hst-install.sh -f -y no -e <email> -p <password> -s <hostname>

Custom installation:

You may specify a number of various flags during installation to only install the features in which you need. To view a list of available options, run:

bash hst-install.sh -h

Alternatively, @gabizz has made available a command-line script generator at https://gabizz.github.io/hestiacp-scriptline-generator/ which allows you to easily generate the installation command via GUI.

Installing & testing development builds

In order to install a development build based on the latest published code, you should first have an instance of Hestia Control Panel set up. If you do not have a server configured, please install the latest stable build using the instructions above before continuing.

PLEASE NOTE: Development builds should not be installed on systems with live production data without understanding the potential risks involved.

To install a development build, first ensure that you have the latest Git upgrade script installed which handles new dependencies added after the 1.0.x branch:

wget -O $HESTIA/bin/v-update-sys-hestia-git https://raw.githubusercontent.com/hestiacp/hestiacp/master/bin/v-update-sys-hestia-git
chmod +x $HESTIA/bin/v-update-sys-hestia-git

Then run the following command:

v-update-sys-hestia-git branchname

Replace branchname with the name of the branch you wish to install from, such as release or master (stable and current development branches, respectively).

Reporting Issues

If you've run into an issue with Hestia Control Panel, please let us know as soon as possible so that we may investigate further and resolve any issues in a timely manner.

Bug reports can be filed using GitHub's Issues feature.

Contributions

If you would like to contribute to the project, please read our submission guidelines for a brief overview of our development processes and standards.

Donations

Hestia Control Panel is open source and completely free for everyone to use.

If you would like to help our developers cover their time and infrastucture costs, or to support the Hestia Control Panel project as a whole, please consider making a donation via PayPal or become a sponsor.

License

Hestia Control Panel is licensed under GPL v3 license, and is based on the VestaCP project.

Copyright

"Hestia Control Panel", "HestiaCP", and the Hestia logo are original copyright of hestiacp.com and the following restrictions apply:

You are allowed to:

use the names "Hestia Control Panel", "HestiaCP", or the Hestia logo in any context directly related to the application or the project. This includes the application itself, local communities and news or blog posts.

You are not allowed to:

sell or redistribute the application under the name "Hestia Control Panel", "HestiaCP", or similar derivatives, including the use of the Hestia logo in any brand or marketing materials related to revenue generating activities,
use the names "Hestia Control Panel", "HestiaCP", or the Hestia logo in any context that is not related to the project,
alter the name "Hestia Control Panel", "HestiaCP", or the Hestia logo in any way.

EquisTango / hestiacp