Upgrade Procedures

Important Notice Before Upgrading

• Always backup your data: Please backup your database and configuration files before upgrading. See Data Backup and Recovery
• Review the changelog: Check the Telegram Channel for update details
• Choose the right time: Perform upgrades during off-peak hours to minimize impact on users

Docker Compose Deployment

One-Click Update

Run the following command in the project root directory to complete the upgrade:

bash upgrade.sh

Post-Upgrade Verification

After upgrading, verify the following:

• Check container status: docker compose ps
• View container logs: docker compose logs -f backend
• Access the frontend and confirm functionality
• Verify the version number has been updated

Backend-Only Update

If you only need to update the backend service (e.g., no changes to the frontend):

docker compose pull backend
docker compose up -d --force-recreate backend

Manual Deployment

Frontend Upgrade

1. Go to the "Source Download" section and download the latest frontend source code
2. Extract the archive to the web root directory, overwriting existing files
3. Run the following commands in the web root directory:

# Update dependencies
php composer.phar upgrade

# Run database migrations
php think migrate:run

Tips

• If you encounter permission issues, ensure the web server has read/write permissions
• If OPcache is installed, consider restarting PHP-FPM to clear the cache

Backend Upgrade

In the directory containing the docker-compose.yml file, run:

docker compose pull backend
docker compose up -d --force-recreate backend