Installation Instructions (Linux)

This article applies to Angelfish v2.33 and earlier.

If you use Angelfish Software v2.4+, please use the new Help Center:



After filling out the Trial form, you will receive a link to download the software and an email that contains a serial code.

You'll need the serial code to unlock the trial version, so you'll want to keep the email handy.


Support is available - if you get stuck, our support team will help!

How to Open a Support Ticket


Before You Begin

Before installing Angelfish, we recommend the following:

1) README: How Angelfish Works

If you're new to Angelfish, the Administrator Essentials article is a must read.

2) Create a role account to own the Angelfish files / folders / processes.

Angelfish processes will not run as root, so you need to create a separate user account to own the files / folders / processes. We typically use "agf" but you can use whatever you'd like.

3) Choose a TCP port for the web interface.

Angelfish uses port 9000 by default, but you can change the port to anything above 1024 or below 65356.

4) Create an installation directory.

The default path is /usr/local/agfs/ -- be sure to assign ownership of the directory to the role account created in step 1.

5) Download the installation package.

The download URL is shown after you fill out the Trial Request form, and we recommend storing the installation package in the role account's home directory. (e.g. /home/agf/)

6) Determine if /tmp/ is executable.

If /tmp/ is mounted as noexec, Angelfish will only install to /usr/local/agfs/


Installation Steps

1) Untar the installation package

$ tar xvf <installation-package-name>.tar


2) Run the Angelfish installer


$ ./


Installer Notes:

  • You'll be prompted to specify your installation directory, data directory, and default file browsing location during the installation process.
  • Port 9000 is used by default for the web UI, but you can specify any port during the install process (above 1024 and below 65356)
  • The Angelfish installation directory contains the control script for the Angelfish processes (agfsctl). You can view help text for agfsctl with the --help flag (i.e. agfsctl --help).


3)  Access the web UI & enter the serial

Training Video (opens in new tab):

Open a browser and type the IP address or hostname of the Angelfish server, plus the TCP port used by Angelfish (default is 9000). For example:

If the port was changed during installation, please replace "9000" with the correct port.

You'll be prompted to enter the serial code from the Trial Version email - simply copy & paste it into field and click the "activate" button. After a few seconds, the UI will refresh and show the Angelfish login screen.


4) Login

Default username / password is:

admin / Angelfish123


Congratulations! Angelfish is now successfully installed. You can read configuration and setup articles here:

Profiles Overview

Profiles, Datasources, & Filters

Was this article helpful?
0 out of 0 found this helpful


Article is closed for comments.