docs(upgrade): note pre-2026-04-19 compose upgrade command

This commit is contained in:
xboard 2026-04-23 12:16:06 +08:00
parent 382efe5aa5
commit cf26ab3210
3 changed files with 17 additions and 0 deletions

View File

@ -116,6 +116,11 @@ docker compose pull && docker compose up -d
The container always runs `php artisan xboard:update` (migrate + plugin install + version cache + theme refresh) on boot, so no extra command is required.
> **Using a `compose.yaml` from before 2026-04-19?** That template did not auto-run `xboard:update` on container start, so use the following command to upgrade instead:
> ```bash
> docker compose pull && docker compose run -it --rm web php artisan xboard:update && docker compose up -d
> ```
## Important Notes
- ⚠️ Ensure firewall is enabled to prevent port 7001 exposure to public

View File

@ -109,6 +109,11 @@ docker compose pull && docker compose up -d
The container always runs `php artisan xboard:update` (migrate + plugin install + version cache + theme refresh) on boot, so no extra command is required.
> **Using a `compose.yaml` from before 2026-04-19?** That template did not auto-run `xboard:update` on container start, so use the following command to upgrade instead:
> ```bash
> docker compose pull && docker compose run -it --rm web php artisan xboard:update && docker compose up -d
> ```
### Routine Maintenance
- Regular log checking: `docker compose logs`
- Monitor system resource usage

View File

@ -64,6 +64,13 @@ cd Xboard
docker compose pull && docker compose up -d
```
The container always runs `php artisan xboard:update` (migrate + plugin install + version cache + theme refresh) on boot, so no extra command is required.
> **Using a `compose.yaml` from before 2026-04-19?** That template did not auto-run `xboard:update` on container start, so use the following command to upgrade instead:
> ```bash
> docker compose pull && docker compose run -it --rm web php artisan xboard:update && docker compose up -d
> ```
### 4. Version Rollback
1. Modify the version number in `docker-compose.yaml` to the version you want to roll back to