Requirements

For a quick setup (with an intention to try out FileAgo), the following requirements should suffice:

1. Linux Operating System
2. Latest version of Docker
3. Git client, docker-compose
4. 4 GB RAM
5. 2 cores
6. Atleast 100 GB disk space available

FileAgo in production

The recommended configuration to run FileAgo in production is listed below:

1. Linux (preferably Ubuntu 24.04 Server)
2. Docker
3. Git client, docker-compose
4. 8 GB RAM
5. 4 cores or more
6. Atleast 500 GB of available disk space

Disk layout

All data is stored under /opt/fileago, so maximum disk space should be allocated to this mount point. A swap space of atleast 8 GB is recommended as well.

/             -> 200 GB
swap          -> 8 GB
/opt/fileago  -> remaining space

FileAgo web interface works best in the latest versions of Chrome and Firefox.

Pre-requisites

The following guide is for Ubuntu, and all commands are being executed as root user.

1. Update the system packages

# apt-get update

2. Remove conflicting packages

# for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do apt-get remove $pkg; done

3. Setup docker’s apt repository

# apt-get update
# apt-get install ca-certificates curl
# install -m 0755 -d /etc/apt/keyrings
# curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
# chmod a+r /etc/apt/keyrings/docker.asc
# echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null
# apt-get update

4. Install and run docker

# apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin
# systemctl start docker
# systemctl enable docker

Reference: https://docs.docker.com/engine/install/ubuntu/

5. Install docker-compose

# curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# chmod +x /usr/local/bin/docker-compose
# ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Reference: https://docs.docker.com/compose/install/