User-Wide MacOS Installation

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
                    

Prebuilt Generic Package

For a user-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:

                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 required user directories:

                mkdir -p $HOME/.local/bin $HOME/.valvoid/fusion
            

Prepend the binary dir to the PATH variable if not already present:

                echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile
            

Reload current user profile to add the binary dir to the PATH variable:

                source $HOME/.zprofile
            

Extract the downloaded archive into the installation directory:

                tar -zxf "$HOME/Downloads/fusion-1.1.0.tar.gz" \
    -C $HOME/.valvoid/fusion
            

Remove the extracted archive:

                rm "$HOME/Downloads/fusion-1.1.0.tar.gz"
            

Make the CLI file executable:

                chmod +x $HOME/.valvoid/fusion/fusion
            

Create a symbolic link to make Fusion user-wide available:

                ln -s $HOME/.valvoid/fusion/fusion $HOME/.local/bin/fusion
            

Verify the installation by checking the version:

                fusion -v
            

Recursive Update

To update Fusion without breaking changes, run the build command:

                fusion build dir.path=$HOME/.valvoid/fusion
            

Make the CLI file executable by all system users:

                chmod +x $HOME/.valvoid/fusion/fusion