Built-in Update Checker

CoinTrail includes a built-in update checker that automatically notifies you when new versions are available. You can access this feature in two locations:

1. Dashboard Widget

The System Health widget on your admin dashboard displays:

• Current Version - The version you're currently running (e.g., v1.0.0)
• Update Status - Shows if you're up to date or if an update is available
• Quick Link - Direct link to view changelog when updates are available

The widget uses color-coded indicators:

• Green - You're running the latest version
• Yellow - A new update is available
• Red - A critical security update is available

2. System Info Page

For detailed system information, go to Admin Panel → Settings → System Info. This page provides:

Available Actions

The System Info page includes two action buttons:

• Check for Updates - Manually refresh the update check (bypasses 24-hour cache)
• Clear All Cache - Clears config, routes, views, and application cache

Before You Update

Check Current Version

You can find your current version in multiple places:

• Dashboard - System Health widget shows version
• Settings → System Info - Detailed version information
• Config file - config/app.php

'version' => '1.0.0',

Review Changelog

Check the Changelog for:

• New features and improvements
• Breaking changes that may affect your customizations
• Database migration requirements
• New dependencies or requirements

Step 1: Create Backup

Backup Files

# Create a backup directory with timestamp
BACKUP_DIR="backups/$(date +%Y%m%d_%H%M%S)"
mkdir -p $BACKUP_DIR

# Backup entire installation
cp -r /path/to/cointrail $BACKUP_DIR/files

# Or create a compressed archive
tar -czf $BACKUP_DIR/files.tar.gz /path/to/cointrail

Backup Database

# MySQL dump
mysqldump -u username -p database_name > $BACKUP_DIR/database.sql

# Or using Laravel's backup package (if installed)
php artisan backup:run

Files to Preserve

Make sure to backup these important files:

• .env - Your environment configuration
• storage/app/ - Uploaded files
• public/uploads/ - Public uploads (if any)
• Any customized files in resources/views/
• Custom language files in lang/

Step 2: Download Update

Step 3: Apply Update

Enable Maintenance Mode

php artisan down --message="Updating... Please check back soon."

Upload New Files

Upload all files from the update package, overwriting existing files. Do NOT overwrite:

• .env file (contains your configuration)
• storage/ directory (contains your data)
• Any files you've customized

Step 4: Post-Update Commands

Run the following commands after uploading the new files:

# Install/update dependencies
composer install --no-dev --optimize-autoloader

# Run database migrations
php artisan migrate --force

# Clear all caches
php artisan optimize:clear

# Rebuild caches
php artisan config:cache
php artisan route:cache
php artisan view:cache

# Update Filament assets (if applicable)
php artisan filament:upgrade

# Disable maintenance mode
php artisan up

Step 5: Verify Update

Post-Update Checklist

• Check admin panel version number has updated
• Verify homepage loads correctly
• Test user login and registration
• Verify cryptocurrency prices are updating
• Test payment gateway (use test mode)
• Check email sending works
• Verify cron jobs are running
• Test any custom features you've added

Update Troubleshooting

500 Error After Update

# Clear all caches
php artisan optimize:clear

# Check logs for errors
tail -f storage/logs/laravel.log

# Regenerate autoload
composer dump-autoload

Migration Errors

If migrations fail:

1. Check storage/logs/laravel.log for specific error
2. Ensure database user has ALTER privileges
3. Try running one migration at a time

Rollback to Previous Version

If the update causes issues:

1. Restore files from backup
2. Restore database from backup
3. Clear caches: php artisan optimize:clear