Migration from Beta

This guide explains how to migrate from Fusionaly Beta to Fusionaly Pro.

What’s Changed

• New manager - The Beta installer (fusionaly-installer) is replaced by the new manager from fusionaly-oss
• New Docker image - karloscodes/fusionaly-beta → karloscodes/fusionaly-pro
• Same data format - Your existing database is fully compatible, no data migration needed

Before You Start

1. Back up your database - Always back up before major upgrades
2. Have your Pro license key ready - Purchase from fusionaly.com if you haven’t

Migration Steps

Step 1: Back Up Your Database

sudo sqlite3 /opt/fusionaly/storage/fusionaly-production.db ".backup /opt/fusionaly/backup-before-pro.db"

Step 2: Replace the Manager

The Beta installer is outdated. Download the new manager which includes the upgrade command:

# Download new manager
curl -L https://github.com/karloscodes/fusionaly-oss/releases/latest/download/fusionaly-linux-$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/') -o /tmp/fusionaly

# Make executable and install
chmod +x /tmp/fusionaly
sudo mv /tmp/fusionaly /usr/local/bin/fusionaly

# Verify
fusionaly version

You should see version 1.3.0 or higher.

Step 3: Run the Upgrade

sudo fusionaly upgrade

This will:

• Back up your database automatically
• Pull the Pro Docker image
• Restart containers with zero downtime

Step 4: Reload Containers

If the upgrade says “Already running Fusionaly Pro” but you’re still seeing the old image, force a container reload:

sudo fusionaly reload

This ensures containers are recreated with the correct Pro image and environment.

Step 5: Enter Your License Key

After the upgrade completes:

1. Visit your dashboard and log in normally
2. Go to Administration → License (/admin/administration/license)
3. Enter your Pro license key
4. Optionally, go to Administration → AI to configure your OpenAI API key

Alternative: Manual Docker Image Change

If you’re running Docker directly (without the manager), simply change your image from karloscodes/fusionaly-beta to karloscodes/fusionaly-pro:

# Pull the Pro image
docker pull karloscodes/fusionaly-pro:latest

# Stop and remove current container
docker stop fusionaly && docker rm fusionaly

# Start with Pro image (use your existing environment variables and volumes)
docker run -d \
  --name fusionaly \
  -p 8080:8080 \
  -e FUSIONALY_DOMAIN="your-domain.com" \
  -e FUSIONALY_PRIVATE_KEY="your-existing-key" \
  -v fusionaly-storage:/app/storage \
  karloscodes/fusionaly-pro:latest

Then log in and enter your license key at /admin/administration/license.

Important Notes

• Keep the same FUSIONALY_PRIVATE_KEY - Changing it breaks visitor tracking continuity

Verify the Upgrade

# Check containers are running Pro image
sudo docker ps --format "table {{.Names}}\t{{.Image}}"

# Should show: karloscodes/fusionaly-pro:latest

Visit your dashboard and confirm:

• Historical data appears correctly
• New Pro menu items are visible (Feed, AI Settings, License)

Troubleshooting

Problem	Solution
upgrade command not found	Download the new manager (Step 2)
“Already running Pro” but still beta image	Run sudo fusionaly reload to force container recreation
CSS/styling broken after upgrade	Run sudo fusionaly reload - you may have an outdated image
Data not showing	Check storage volume path matches previous install
Can’t find license page	Go to /admin/administration/license directly
AI features not working	Enter OpenAI API key in Administration → AI

Help

• Pro support: Email support included with your license
• Community: GitHub Issues