# V2board wyx2685 Migration Guide

This guide explains how to migrate from V2board wyx2685 version (2023/11/17) to Xboard.

⚠️ Important migration notes:
- Device limitation feature will be lost
- Special Trojan features will be lost
- Hysteria2 routes need to be reconfigured

### 1. Database Changes Overview

- `v2_plan` table:
  - Removed `device_limit` (nullable)

- `v2_server_hysteria` table:
  - Removed `version`
  - Removed `obfs`
  - Removed `obfs_password`

- `v2_server_trojan` table:
  - Removed `network`
  - Removed `network_settings`

- `v2_user` table:
  - Removed `device_limit`

### 2. Prerequisites

⚠️ Please complete the basic Xboard installation first (SQLite not supported):
- [Docker Compose Deployment](../installation/docker-compose.md)
- [aaPanel + Docker Deployment](../installation/aapanel-docker.md)
- [aaPanel Deployment](../installation/aapanel.md)

### 3. Migration Steps

#### Docker Environment

```bash
# 1. Stop services
docker compose down

# 2. Clear database
docker compose run -it --rm web php artisan db:wipe

# 3. Import old database (Important)
# Please manually import the V2board wyx2685 database

# 4. Execute migration
docker compose run -it --rm web php artisan migratefromv2b wyx2685
```

#### aaPanel Environment

```bash
# 1. Clear database
php artisan db:wipe

# 2. Import old database (Important)
# Please manually import the V2board wyx2685 database

# 3. Execute migration
php artisan migratefromv2b wyx2685
```

### 4. Configuration Migration

After completing the data migration, you need to migrate the configuration file:
- [Configuration Migration Guide](./config.md)