Install FileAgent on Linux

#Before you begin

• Use a 64-bit Debian/Ubuntu-based Linux server that stays on and can reach your endpoints.
• You need root/sudo rights — installation sets up background services and a dedicated service account.
• Have your license key ready if you purchased a plan (Free needs none).

#Install

1. Download the Debian package using either option:
   • In a browser: open fileagent.app/download and choose Linux.
   • From the command line: install curl and jq, then resolve the current package from FileAgent's release manifest and download it:

     sudo apt update
     sudo apt install curl jq
     
     DEB_URL="$(
       curl -fsSL https://fileagent.app/downloads/latest.json |
         jq -er '.downloads.linux_deb.url'
     )"
     curl -fL "$DEB_URL" -o fileagent_amd64.deb

     This command always uses the release marked as current, so you do not need to put a version number in the URL.

2. Install it with apt so dependencies resolve automatically:

   sudo apt install ./fileagent_amd64.deb

3. To choose a custom console port during install, set it on the same command:

   sudo FILEAGENT_WEB_PORT=8443 apt install ./fileagent_amd64.deb

The package installs the web console and scheduler as background services and starts them automatically.

#Open the console

From a browser that can reach the server, open it over HTTPS:

https://<server-ip-or-hostname>:<port>

You can change the console port later:

sudo fileagent configure-port 8443
sudo fileagent status

#Verify it's running

• sudo fileagent status reports the services as running.
• The console loads over HTTPS and shows the first-run setup screen.
• After a reboot, the services start again automatically.

Next: create your administrator account.