AppleAutoPro Docs

English

简体中文

English

简体中文

Appearance

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
bash upgrade_en.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):

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

Using the Latest Upgrade Script ​

When the release notes require using the latest upgrade script, or if the local upgrade script is not working correctly, go to the installation directory and run the following commands:

Personal edition update command ​

bash
bash <(curl -Ls https://raw.githubusercontent.com/SideCloudGroup/AppleAutoPro-Personal/refs/heads/v4/upgrade_en.sh)

Business edition update command ​

bash
bash <(curl -Ls https://raw.githubusercontent.com/SideCloudGroup/AppleAutoPro-Business/refs/heads/v4/upgrade_en.sh)

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:
bash
# 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:

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