Before installing Angelfish, we recommend the following:
1) 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.
2) 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.
3) 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.
4) Download the installation package.
The download URL is available in the Trial Version email, and we recommend storing the installation package in the role account's home directory. (e.g. /home/agf/)
5) Determine if /tmp/ is executable.
If /tmp/ is mounted as noexec, Angelfish will only install to /usr/local/agfs/
Angelfish processes will not run as root -- use the role account for installation.
Angelfish can be installed to any path. However...
If /tmp/ is mounted as noexec, Angelfish will install to /usr/local/agfs/.
1) Untar the installation package
$ tar xvf <installation-package-name>.tar
2) Run the Angelfish installer
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
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.
Default username / password is:
admin / Angelfish123
Congratulations! Angelfish is now successfully installed. You can read configuration and setup articles here: