From 267aeec5ba1a52178a5bea25fabd26a08eac0b3e Mon Sep 17 00:00:00 2001
From: yinjianm <admin@mxmicah.com>
Date: Sun, 22 Feb 2026 03:58:02 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     |  1 +
 docs/en/migration/new-dev-to-latest-docker.md | 59 +++++++++++++++++++
 2 files changed, 60 insertions(+)
 create mode 100644 docs/en/migration/new-dev-to-latest-docker.md

diff --git a/README.md b/README.md
index bb1934a..89f7208 100644
--- a/README.md
+++ b/README.md
@@ -57,6 +57,7 @@ docker compose up -d
 - [Migrate from v2board dev](./docs/en/migration/v2board-dev.md)
 - [Migrate from v2board 1.7.4](./docs/en/migration/v2board-1.7.4.md)
 - [Migrate from v2board 1.7.3](./docs/en/migration/v2board-1.7.3.md)
+- [Upgrade from new-dev to latest Docker](./docs/en/migration/new-dev-to-latest-docker.md)
 
 ## 🛠️ Tech Stack
 
diff --git a/docs/en/migration/new-dev-to-latest-docker.md b/docs/en/migration/new-dev-to-latest-docker.md
new file mode 100644
index 0000000..b4fecf2
--- /dev/null
+++ b/docs/en/migration/new-dev-to-latest-docker.md
@@ -0,0 +1,59 @@
+# Upgrade from `new-dev` to Latest Docker Version
+
+This guide uses Docker Compose to move from an old `new-dev` deployment flow to the latest version.
+
+## 1. Get the project
+
+```bash
+git clone -b compose --depth 1 https://github.com/Micah123321/Xboard Xboard-new
+cd Xboard-new
+```
+
+If your local file is `compose.sample.yaml`, create `compose.yaml` first:
+
+```bash
+cp compose.sample.yaml compose.yaml
+```
+
+## 2. Initialize with built-in SQLite + Redis
+
+```bash
+docker compose run -it --rm \
+    -e ENABLE_SQLITE=true \
+    -e ENABLE_REDIS=true \
+    -e ADMIN_ACCOUNT=admin@demo.com \
+    web php artisan xboard:install
+```
+
+## 3. Update `.env` to MySQL configuration
+
+Edit `.env` and switch database settings to MySQL:
+
+```env
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=xboard
+DB_USERNAME=your_user
+DB_PASSWORD=your_password
+```
+
+Then run:
+
+```bash
+docker compose run -it --rm web php artisan xboard:update
+```
+
+## 4. Start services
+
+```bash
+docker compose up -d
+```
+
+## 5. Check status
+
+```bash
+docker compose ps
+docker compose logs -f web
+docker compose logs -f horizon
+```