Fusionaly Manager

Fusionaly Manager is a command-line tool that simplifies installation, updates, and maintenance of your Fusionaly instance. It works with both Free and Pro editions.

Features

• One-command installation - Set up Fusionaly with SSL certificates and reverse proxy
• Automatic updates - Keep your installation up to date via cron jobs
• Database backups - Daily, weekly, and monthly automated backups
• Easy maintenance - Reload configuration, restore backups, change passwords

Installation

Download and run the installer:

curl -fsSL https://fusionaly.com/install | sh

The installer will:

1. Prompt for your domain name
2. Configure SSL certificates via Let’s Encrypt
3. Set up Caddy as a reverse proxy
4. Pull and start the Docker containers
5. Configure automatic updates and backups

Commands

install

Install Fusionaly on a fresh server:

fusionaly install

update

Update to the latest version:

fusionaly update

This command:

1. Backs up your database
2. Pulls the latest Docker image
3. Restarts containers with zero downtime
4. Updates the manager binary if needed

reload

Reload containers with the current configuration (without backup):

fusionaly reload

Useful after manually editing the .env file.

restore-db

Interactively restore from a backup:

fusionaly restore-db

Lists available backups and prompts you to select one.

change-admin-password

Change the admin user password:

fusionaly change-admin-password

update-license-key

Update your license key:

fusionaly update-license-key [key]

version

Show the manager version:

fusionaly version

Configuration

Configuration is stored in /opt/fusionaly/.env:

FUSIONALY_DOMAIN=analytics.example.com
APP_IMAGE=karloscodes/fusionaly-pro:latest
CADDY_IMAGE=caddy:2.7-alpine
INSTALL_DIR=/opt/fusionaly
BACKUP_PATH=/opt/fusionaly/storage/backups
VERSION=1.0.0
FUSIONALY_PRIVATE_KEY=your-private-key
FUSIONALY_LICENSE_KEY=your-license-key

upgrade

Upgrade from Free to Pro edition:

fusionaly upgrade

This command backs up your database, switches to the Pro Docker image, and restarts the containers. After upgrading, visit your dashboard to enter your license key.

Backup System

The manager automatically creates backups on a schedule:

• Daily backups - Every night, retained for 7 days
• Weekly backups - Every Sunday, retained for 14 days
• Monthly backups - First of each month, retained for 90 days

Backups are stored in /opt/fusionaly/storage/backups/.

Manual Backup

The update command creates a backup before updating. For manual backups, you can use sqlite3 directly:

sqlite3 /opt/fusionaly/storage/fusionaly-production.db ".backup /path/to/backup.db"

Directory Structure

/opt/fusionaly/
├── .env                 # Configuration
├── storage/
│   ├── fusionaly-production.db  # SQLite database
│   └── backups/         # Automated backups
└── logs/                # Application logs

Logs

View application logs:

docker logs fusionaly-app

View Caddy (reverse proxy) logs:

docker logs fusionaly-caddy

Troubleshooting

Container not starting

Check Docker logs:

docker logs fusionaly-app

SSL certificate issues

Ensure your DNS is pointing to the server and ports 80/443 are open:

curl -I https://your-domain.com

Database locked

If you see database lock errors, ensure only one instance is running:

docker ps | grep fusionaly

Uninstalling

To completely remove Fusionaly:

# Stop and remove containers
docker stop fusionaly-app fusionaly-caddy
docker rm fusionaly-app fusionaly-caddy

# Remove data (WARNING: destroys all analytics data)
rm -rf /opt/fusionaly

# Remove the manager binary
rm /usr/local/bin/fusionaly