Installation

One command installs FloppyOps completely — Apache, PHP, MariaDB, database, cron jobs and permissions.

Prerequisites

Run on a fresh Debian 12+ or Ubuntu 22.04+ server as root:

apt update && apt upgrade -y && apt install -y curl sudo

Automatic Installation (recommended)

One command — everything is set up automatically.

curl -sL https://release.floppyops.com/setup.sh | sudo bash

After installation, the script displays all credentials and creates a setup page in the browser.

What gets installed?

Apache2 — Web server with mod_rewrite, mod_ssl, mod_proxy
PHP 8.x — with curl, mbstring, mysql, xml, zip, gd, ssh2
MariaDB — Database (auto-configured)
Composer — PHP package manager
Webmin — Server administration (port 10000)
Cron Job — for schedules, maintenance & alerts

System Requirements

Managed Proxmox Servers

Manual Installation

If you prefer to install step by step:

1 Install system packages

apt update && apt install -y apache2 mariadb-server php php-curl php-mbstring \
    php-mysql php-xml php-zip php-gd php-ssh2 composer unzip curl sudo

2 Download FloppyOps

cd /var/www/html
curl -sL https://release.floppyops.com/api/download/latest -o floppyops.zip
unzip floppyops.zip
mv floppyops-* floppyops
cd floppyops
composer install --no-dev

3 Create database

mysql -u root <<SQL
CREATE DATABASE floppyops CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'floppyops'@'localhost' IDENTIFIED BY 'SECURE_PASSWORD';
GRANT ALL ON floppyops.* TO 'floppyops'@'localhost';
FLUSH PRIVILEGES;
SQL

mysql -u root floppyops < /var/www/html/floppyops/database/schema.sql

Then update config/database.php with your credentials.

4 Configure Apache

a2enmod rewrite headers ssl proxy proxy_http proxy_wstunnel
systemctl restart apache2

5 Set permissions

chown -R www-data:www-data /var/www/html/floppyops
chmod -R 755 /var/www/html/floppyops
chmod -R 775 /var/www/html/floppyops/{logs,temp,storage,certs,public/branding}

6 Setup cron job

(crontab -u www-data -l 2>/dev/null; echo "* * * * * php /var/www/html/floppyops/cron.php >> /var/www/html/floppyops/logs/cron.log 2>&1") | crontab -u www-data -

First Login

FloppyOps is now available at: http://YOUR-SERVER-IP/floppyops

Username:admin
Password:admin123
Change the password immediately! (Profile icon bottom left in sidebar)

Next Steps

  1. Change password — Profile icon bottom left
  2. Add Proxmox server — Dashboard > Add Server > Enter API token
  3. Install agent — Automatically installed when connecting (enter SSH credentials > click "Install Agent")
  4. Activate license — Settings > License (optional, Community is free)