Skip to content

Building packages

INFO

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

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

Installing Lokahostcp 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
bash
# Replace with https://github.com/username/lokahostcp.git if you want to test a branch that you created yourself
git clone https://github.com/lokahostcp/lokahostcp.git
cd ./lokahostcp/

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

cd ./src/

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

cd ../install

bash lcp-install-{os}.sh --with-debs /tmp/lokahostcp-src/deb/

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

Build packages only

bash
# Only Lokahostcp
./lcp_autocompile.sh --lokahostcp --noinstall --keepbuild '~localsrc'
bash
# Lokahostcp + lokahostcp-nginx and lokahostcp-php
./lcp_autocompile.sh --all --noinstall --keepbuild '~localsrc'

Build and install packages

INFO

Use if you have Lokahostcp already installed, for your changes to take effect.

bash
# Only Lokahostcp
./lcp_autocompile.sh --lokahostcp --install '~localsrc'
bash
# Lokahostcp + lokahostcp-nginx and lokahostcp-php
./lcp_autocompile.sh --all --install '~localsrc'

Updating Lokahostcp 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 lokahostcp package. If you need to build lokahostcp-nginx or lokahostcp-php, use one of the previous commands.

  1. Install Node.js Download or use Node Source APT
bash
v-update-sys-lokahostcp-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:

bash
dpkg: error processing package lokahostcp (–install):
dependency problems - leaving unconfigured

To solve this issue, run:

bash
apt install -f

Released under the GPLv3 License.