Manual Installation Upgrade

This guide covers upgrading MythicalDash when you have installed it manually without Docker.

To keep it simple and safe, we will:

• Use absolute paths with variables
• Preserve critical data in a temporary upgrade directory
• Clear old application files before restoring and updating

Set these variables once (adjust if your path differs):

MD_DIR=/var/www/mythicaldash-v3
UPG_DIR=/var/www/mythicaldash_upgrade_dir

Step 1: Create Backup

Before starting the upgrade process, create a complete backup of your current installation.

Database Backup

cd "$MD_DIR"
mariadb-dump -p mythicaldash_remastered > /var/www/mythicaldash_backup.sql

Files Backup

zip -r /var/www/mythicaldash_backup.zip "$MD_DIR"/

Step 2: Prepare and Preserve Important Files

Create an upgrade directory and move critical items you want to keep:

mkdir -p "$UPG_DIR"/public "$UPG_DIR"/storage
mv "$MD_DIR"/backend/public/* "$UPG_DIR"/public/ 2>/dev/null || true
mv "$MD_DIR"/backend/storage/backups "$UPG_DIR"/storage/ 2>/dev/null || true
mv "$MD_DIR"/backend/storage/addons "$UPG_DIR"/storage/ 2>/dev/null || true
mv "$MD_DIR"/backend/storage/.env "$UPG_DIR"/storage/ 2>/dev/null || true

Step 3: Download the Update

Download the latest version from GitHub without changing directories:

curl -Lo /tmp/MythicalDash.zip https://github.com/MythicalLTD/MythicalDash/releases/latest/download/MythicalDash.zip

Step 4: Clear Old Files and Install New Version

Remove old files and unzip the new release:

rm -rf "$MD_DIR"
mkdir -p "$MD_DIR"
unzip -o /tmp/MythicalDash.zip -d "$MD_DIR"

Step 5: Restore Preserved Files

mkdir -p "$MD_DIR"/backend/public "$MD_DIR"/backend/storage
mv "$UPG_DIR"/public/* "$MD_DIR"/backend/public/ 2>/dev/null || true
mv "$UPG_DIR"/storage/backups "$MD_DIR"/backend/storage/ 2>/dev/null || true
mv "$UPG_DIR"/storage/addons "$MD_DIR"/backend/storage/ 2>/dev/null || true
mv "$UPG_DIR"/storage/.env "$MD_DIR"/backend/storage/ 2>/dev/null || true

Step 6: Update Dependencies

Update the core components of the dashboard:

cd "$MD_DIR"/backend
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

Step 7: Database Updates

Update your database schema for the newest version:

cd "$MD_DIR"
php mythicaldash migrate

Step 8: Set Permissions

Set the proper owner of the files to your webserver user:

chown -R www-data:www-data "$MD_DIR"/*

::::note The webserver user may vary by system. Common users include www-data, nginx, apache, or nobody. ::::

Verification

After completing the upgrade:

1. Check your website - Visit your MythicalDash URL to ensure it loads properly
2. Verify functionality - Test key features like server management
3. Check logs - Review application logs for any errors

Troubleshooting

If you encounter issues:

• Check permissions: Ensure all files have correct ownership
• Review logs: Check "$MD_DIR"/storage/logs/ for errors
• Restore backup: If needed, restore from your backup files

Done

You are now running the latest version of MythicalDash! The upgrade process is complete.