From 5462b7036a8bc12489f39496e88571093e370dbe Mon Sep 17 00:00:00 2001 From: xboard Date: Thu, 23 Apr 2026 12:16:06 +0800 Subject: [PATCH] docs(upgrade): note pre-2026-04-19 compose upgrade command --- docs/en/installation/1panel.md | 5 +++++ docs/en/installation/aapanel-docker.md | 5 +++++ docs/en/installation/docker-compose.md | 7 +++++++ 3 files changed, 17 insertions(+) diff --git a/docs/en/installation/1panel.md b/docs/en/installation/1panel.md index 24c2b6b..bbb7502 100644 --- a/docs/en/installation/1panel.md +++ b/docs/en/installation/1panel.md @@ -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 diff --git a/docs/en/installation/aapanel-docker.md b/docs/en/installation/aapanel-docker.md index 6268ae1..0b4fa55 100644 --- a/docs/en/installation/aapanel-docker.md +++ b/docs/en/installation/aapanel-docker.md @@ -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 diff --git a/docs/en/installation/docker-compose.md b/docs/en/installation/docker-compose.md index a97c00d..5d4042b 100644 --- a/docs/en/installation/docker-compose.md +++ b/docs/en/installation/docker-compose.md @@ -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