Administration

This guide covers how to manage your Fusionaly installation. Choose the section that matches your deployment method.

CLI Installation Management

If you installed Fusionaly using the automated installer, you have access to the fnctl CLI tool.

CLI Tool Overview

The automated installation installs Fusionaly to /opt/fusionaly and adds the fnctl command to your system PATH, making it available from anywhere.

Key Files and Directories

/opt/fusionaly/
├── Caddyfile                    # Web server configuration
├── logs/
│   ├── caddy.log                # Web server logs
│   ├── fusionaly.log            # Application logs
│   └── updater.log              # Auto-updater logs
└── storage/
    ├── backups/                 # Daily database backups
    │   └── backup_YYYYMMDD_HHMMSS.db
    └── fusionaly-production.db  # Main database

Administrative Commands

Available CLI Commands

View all available commands:

fnctl --help

Administrative commands:

# Change admin password
sudo fnctl change-admin-password

# Force manual update (updates normally run automatically at 3:00 AM)
sudo fnctl update

# Reload configuration and restart services
sudo fnctl reload

# Restore from backup
sudo fnctl restore

# Check version
fnctl version

View Logs

View real-time logs:

# Application logs
sudo tail -f /opt/fusionaly/logs/fusionaly.log

# Web server logs
sudo tail -f /opt/fusionaly/logs/caddy.log

# Auto-updater logs
sudo tail -f /opt/fusionaly/logs/updater.log

Database Management

Access the database:

sudo sqlite3 /opt/fusionaly/storage/fusionaly-production.db

View automatic backups (created nightly at 3:00 AM):

ls -la /opt/fusionaly/storage/backups/

Restore from backup:

sudo fnctl stop
sudo cp /opt/fusionaly/storage/backups/backup_YYYYMMDD_HHMMSS.db /opt/fusionaly/storage/fusionaly-production.db
sudo fnctl start

Automatic Maintenance

The system automatically performs the following maintenance tasks every night at 3:00 AM:

• Updates: Checks for and installs Fusionaly updates
• Backups: The automated installer creates comprehensive backup schedules:
  • Daily backups: Full database backups created every night (retained for 30 days)
  • Weekly backups: Additional weekly snapshots for extended recovery options
  • Monthly backups: Long-term monthly archives for historical data preservation
• Log rotation: Archives old log files

Docker Installation Management

If you deployed Fusionaly using Docker, you can manage your installation using standard Docker commands for container operations, log viewing, and database access.

Server Requirements

Fusionaly is designed to run efficiently with minimal server resources. You can get started with very modest specifications.

Minimum Requirements

• CPU: 1 vCPU/Core
• RAM: 512MB (sufficient to get started)
• Storage: 10GB SSD

Network Requirements

Inbound:

• Ports 80 (HTTP) and 443 (HTTPS) must be open for Let’s Encrypt certificate setup, verification, and normal operations

Outbound:

• General internet access required for Let’s Encrypt certificate renewal and OpenAI API communication

SSL Certificate:

• Automatically provisioned during installation with Let’s Encrypt (for automated installer) or configured manually