Upgrade a Seafile cluster from 11.0 to 12.0¶

Stop the seafile service in all nodes
```
docker compose down
```

Download the docker-compose files for Seafile 12

wget -O .env https://manual.seafile.com/12.0/repo/docker/cluster/env
wget https://manual.seafile.com/12.0/repo/docker/cluster/seafile-server.yml

Modify .env:
- Generate a JWT key
```
pwgen -s 40 1

# e.g., EkosWcXonPCrpPE9CFsnyQLLPqoPhSJZaqA3JMFw
```
- Fill up the following field according to your configurations using in Seafile 11:
```
SEAFILE_SERVER_HOSTNAME=<your loadbalance's host>
SEAFILE_SERVER_PROTOCOL=https # or http
SEAFILE_MYSQL_DB_HOST=<your mysql host>
SEAFILE_MYSQL_DB_USER=seafile # if you don't use `seafile` as your Seafile server's account, please correct it
SEAFILE_MYSQL_DB_PASSWORD=<your mysql password for user `seafile`>
JWT_PRIVATE_KEY=<your JWT key generated in Sec. 3.1>
```
  Remove the variables using in Cluster initialization
  
  Since Seafile has been initialized in Seafile 11, the variables related to Seafile cluster initialization can be removed from .env:
  - INIT_SEAFILE_MYSQL_ROOT_PASSWORD
  - CLUSTER_INIT_MODE
  - CLUSTER_INIT_MEMCACHED_HOST
  - CLUSTER_INIT_ES_HOST
  - CLUSTER_INIT_ES_PORT
  - INIT_S3_STORAGE_BACKEND_CONFIG
  - INIT_S3_COMMIT_BUCKET
  - INIT_S3_FS_BUCKET
  - INIT_S3_BLOCK_BUCKET
  - INIT_S3_KEY_ID
  - INIT_S3_USE_V4_SIGNATURE
  - INIT_S3_SECRET_KEY
  - INIT_S3_AWS_REGION
  - INIT_S3_HOST
  - INIT_S3_USE_HTTPS
Start the Seafile in a node
Note

According to this upgrade document, a frontend service will be started here. If you plan to use this node as a backend node, you need to modify this item in .env and set it to backend:
```
CLUSTER_MODE=backend
```
```
docker compose up -d
```

Upgrade Seafile

docker exec -it seafile bash
# enter the container `seafile`

# stop servers
cd /opt/seafile/seafile-server-latest
./seafile.sh stop
./seahub.sh stop

# upgrade seafile
cd upgrade
./upgrade_11.0_12.0.sh

Success

After upgrading the Seafile, you can see the following messages in your console:

Updating seafile/seahub database ...

[INFO] You are using MySQL
[INFO] updating seafile database...
[INFO] updating seahub database...
[INFO] updating seafevents database...
Done

migrating avatars ...

Done

updating /opt/seafile/seafile-server-latest symbolic link to /opt/seafile/seafile-pro-server-12.0.6 ...



-----------------------------------------------------------------
Upgraded your seafile server successfully.
-----------------------------------------------------------------

Then you can exit the container by exit

Restart current node
```
    docker compose down
    docker compose up -d
```
Tip
- You can use docker logs -f seafile to check whether the current node service is running normally
Operations for other nodes
- Download and modify .env similar to the first node (for backend node, you should set CLUSTER_MODE=backend)
- Start the Seafile server:
```
docker compose up -d
```