Required Environment
Fusion requires at least PHP 8.1.0 to run. Check the installed version on
your system:
php -v
Ensure the required curl and recommended zip extensions are available:
php -m
Note
If the zip extension is missing, Fusion will use the built-in Phar
extension to process archives, which uses more memory.
Prebuilt Generic Package
For a system-wide standalone installation from scratch, we use a prebuilt
executable package from the
generic package registry.
Download the compressed standalone-build.tar.gz archive for version 1.1.0:
sudo curl -fL "https://gitlab.com/api/v4/projects/62331610/packages/generic/fusion/1.1.0/standalone-build.tar.gz" \
-o "$HOME/Downloads/fusion-1.1.0.tar.gz"
Create the system-wide installation directories:
sudo mkdir -p /opt/bin /opt/valvoid/fusion
Extract the downloaded archive into the installation directory:
sudo tar -zxf "$HOME/Downloads/fusion-1.1.0.tar.gz" \
-C /opt/valvoid/fusion
Remove the extracted archive:
sudo rm "$HOME/Downloads/fusion-1.1.0.tar.gz"
Make the CLI file executable by all system users:
sudo chmod +x /opt/valvoid/fusion/fusion
Create a symbolic link to make Fusion globally available:
sudo ln -s /opt/valvoid/fusion/fusion /opt/bin/fusion
Append the /opt/bin directory to the system-wide PATH variable:
sudo nano /etc/environment
Reload the updated PATH variable:
source /etc/environment
Verify the installation by checking the version as a regular system user
in a new terminal session, without using sudo:
fusion -v
Note
The documentation points to a fixed, documented version. To get the latest release, for example with patches, use the update steps below.
Recursive Update
To update Fusion without breaking changes, run the
build command:
sudo fusion build dir.path=/opt/valvoid/fusion
Make the CLI file executable by all system users:
sudo chmod +x /opt/valvoid/fusion/fusion
Note
For upgrade, see the Upgrade page in the documentation if any.