Installation

Automated Installation

This method provides a streamlined installation process with automatic updates, ideal for Ubuntu Server users.

Recommended Hosting Providers

For the automated installation, we recommend using DigitalOcean or Hetzner as they provide reliable, affordable VPS hosting with public IP addresses.

Requirements:

• Public IP address
• Ubuntu Server 20.04+

Important: The installer does not harden your server. You are responsible for securing it before running the installer. At minimum: set up a non-root user with SSH key authentication, disable password login, and configure a firewall. Follow DigitalOcean’s Ubuntu Server Setup Guide or your provider’s equivalent.

The installer configures UFW to allow ports 80/443 automatically.

DNS Setup

Point your domain to your server before installing (A record, optionally AAAA). The installer auto-configures SSL via Let’s Encrypt.

1. Choose Your Edition

• Free - Open source, full analytics ($0)
• Pro - Adds Ask AI, Activity Feed ($99 one-time)

For Pro, purchase your license from our pricing section.

2. Install

The installer sets up SSL (Let’s Encrypt), Caddy reverse proxy, automatic updates, and daily/weekly/monthly database backups.

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

Cloudflare (Recommended)

We strongly recommend putting your Fusionaly instance behind Cloudflare in proxied mode (orange cloud icon). This filters out bot scanners, vulnerability probes, and automated attacks before they reach your server — keeping your analytics clean and reducing server load.

Setup:

1. Add your domain to Cloudflare (free plan works)
2. Point the DNS A record to your server IP
3. Ensure the proxy toggle is enabled (orange cloud)
4. SSL mode: Full (strict)

---

Self-Managed (Docker)

For non-Ubuntu systems or manual setup.

Edition	Image
Free	karloscodes/fusionaly
Pro	karloscodes/fusionaly-pro

Both support AMD64 and ARM64. Use latest tag.

Quick Start

docker run -d \
  --name fusionaly \
  -p 8080:8080 \
  -e FUSIONALY_DOMAIN="your-domain.com" \
  -e FUSIONALY_PRIVATE_KEY="$(openssl rand -hex 32)" \
  -v fusionaly-storage:/app/storage \
  -v fusionaly-logs:/app/logs \
  karloscodes/fusionaly:latest  # or fusionaly-pro

For Pro, enter your license key during onboarding in the dashboard.

Environment Variables

Variable	Required	Description
FUSIONALY_DOMAIN	Yes	Your domain name
FUSIONALY_PRIVATE_KEY	Yes	Encryption key (openssl rand -hex 32)
FUSIONALY_LOG_LEVEL	No	debug, info, warn, error (default: info)

Data Persistence

Mount volumes for /app/storage (database) and /app/logs.

Updating

docker pull karloscodes/fusionaly:latest
docker stop fusionaly && docker rm fusionaly
# Re-run with same FUSIONALY_PRIVATE_KEY

Note: Self-managed deployments don’t include automatic updates or backups. Handle these yourself.