Intro fuse

Try the Fuse Panel

Get started with the Fuse Panel in 4 easy steps.

Select your method

  • Binary
  • Docker

We offer two installation methods. You can download and run the binaries, or pull our docker container.

1

Download

Download Fuse Panel binary from our servers. We supply binaries for Linux (x64) and macOS (x64). It's not necessary to run the Fuse Panel on the same server as Passenger.

# download binary
curl -sL -o fuse_panel_linux_64.tar.gz https://www.phusionpassenger.com/fuse-panel/download/linux_x64
# create a directory for the fuse panel application
mkdir fuse-panel
# extract the tarball into the directory
tar xvf fuse_panel_linux_64.tar.gz -C fuse-panel
Please agree to the EULA to see instructions
# download binary
curl -sL -o fuse_panel_macos_64.tar.gz https://www.phusionpassenger.com/fuse-panel/download/macos_x64
# create a directory for the fuse panel application
mkdir fuse-panel
# extract the tarball into the directory
tar xvf fuse_panel_macos_64.tar.gz -C fuse-panel
Please agree to the EULA to see instructions
2

Start

Start Fuse Panel. The first time you start the Fuse Panel you must set the ADMIN_USERNAME and ADMIN_PASSWORD environment variables.

Available commandline options:

  • --config string
    Config file to load
  • --bind string
    Host name or IP to listen on
  • --port int
    Port to listen on (default 3001)
  • --dbfile string
    Database file to use (default "./test.db")
  • --frontend-assets-dir string
    Directory containing Fuse Panel frontend assets (default "./frontend-dist")
  • --disable-usage-statistics
    Disable sending usage statistics to Phusion
  • --version
    Show version number
  • --verbose
    Print debug logs
  • --help
    Show help message

# assuming you extracted the files to the fuse-panel directory
cd fuse-panel
# start the application
ADMIN_USERNAME=<preferred_admin_username> ADMIN_PASSWORD=<preferred_admin_password> ./fuse-panel
Please agree to the EULA to see instructions
Browser
3

Open web interface

The Fuse Panel will report the hostname or ip and port it's listening on. Point your browser to that location to open the Fuse Panel web interface. By default it will be available at http://localhost:3001.

4

Check your Passenger version

To allow Passenger to connect to the Fuse Panel, Passenger must be at the latest version. The latest version is 6.0.0. Read the upgrade guide.

After you've made sure that you're running an up-to-date version of Passenger you can follow the instructions in the Fuse Panel web interface to connect it to the Fuse Panel.

1

Install required software

We distribute the application in a Docker image. If you haven't already, install Docker. It is not necessary to run Docker on the same server as Passenger. How to install Docker.

Moby
2

Login to our Docker repo

We've set up a private docker repository to host the image. To pull the image, you need to login to our repository.

unset HISTFILE ; docker login -u beta -p "d248NAQMN3rWqUVOmt5S6ojL" hub.phusionpassenger.com
Please agree to the EULA to see instructions
3

Download and run installation script

The installation script will automatically pull the image and run the container. You must set the ADMIN_USERNAME and ADMIN_PASSWORD environment variables. The script will report the location of the web interface.

# download installation script
curl -sSL -o run-fuse-panel https://www.phusionpassenger.com/run-fuse-panel
# run installation script
ADMIN_USERNAME=<preferred_admin_username> ADMIN_PASSWORD=<preferred_admin_password> bash run-fuse-panel
Please agree to the EULA to see instructions
Browser
4

Open web interface

The script from step 3 will report the hostname or ip and port it's listening on. Point your browser to that location to open the Fuse Panel web interface.

5

Check your Passenger version

To allow Passenger to connect to the Fuse Panel, Passenger must be at the latest version. The latest version is 6.0.0. Read the upgrade guide.

After you've made sure that you're running an up-to-date version of Passenger you can follow the instructions in the Fuse Panel web interface to connect it to the Fuse Panel.