You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.4 KiB

Building packages

::: info For building hestia-nginx or hestia-php, at least 2 GB of memory is required! :::

Here is more detailed information about the build scripts that are run from src:

Installing Hestia from a branch

The following is useful for testing a Pull Request or a branch on a fork.

  1. Install Node.js Download or use Node Source APT
# Replace with https://github.com/username/hestiacp.git if you want to test a branch that you created yourself
git clone https://github.com/hestiacp/hestiacp.git
cd ./hestiacp/

# Replace main with the branch you want to test
git checkout main

# Install Dependencies
npm install
# Build
npm run build

cd ./src/

# Compile packages
./hst_autocompile.sh --all --noinstall --keepbuild '~localsrc'

cd ../install

bash hst-install-{os}.sh --with-debs /tmp/hestiacp-src/deb/

Any option can be appended to the installer command. See the complete list.

Build packages only

# Only Hestia
./hst_autocompile.sh --hestia --noinstall --keepbuild '~localsrc'
# Hestia + hestia-nginx and hestia-php
./hst_autocompile.sh --all --noinstall --keepbuild '~localsrc'

Build and install packages

::: info Use if you have Hestia already installed, for your changes to take effect. :::

# Only Hestia
./hst_autocompile.sh --hestia --install '~localsrc'
# Hestia + hestia-nginx and hestia-php
./hst_autocompile.sh --all --install '~localsrc'

Updating Hestia from GitHub

The following is useful for pulling the latest staging/beta changes from GitHub and compiling the changes.

::: info The following method only supports building the hestia package. If you need to build hestia-nginx or hestia-php, use one of the previous commands. :::

  1. Install Node.js Download or use Node Source APT
v-update-sys-hestia-git [USERNAME] [BRANCH]

Note: Sometimes dependencies will get added or removed when the packages are installed with dpkg. It is not possible to preload the dependencies. If this happens, you will see an error like this:

dpkg: error processing package hestia (install):
dependency problems - leaving unconfigured

To solve this issue, run:

apt install -f