Upgrade xlwings Server¶

Prerequisites¶

This guide assumes that you have set up your local Git repository according to Git Repository Setup.

Upgrade process¶

Fetch changes from upstream/legacy and merge them:

git fetch upstream
git merge --no-edit upstream/legacy

If you get a merge conflict, resolve it.
Compile the requirements files:
```
python run.py deps compile
```
Commit and push the requirements files to your repo (feel free to use a Git UI instead):
```
git add .
git commit -m "updated requirements"
git push origin main
```
Update your requirements locally:
```
uv pip sync requirements-dev.txt
```
If you use Docker, rebuild your container instead:
```
docker compose build
```

Merge vs. Rebase¶

Merge is recommended over rebase:

Potential merge conflicts can be resolved in a single step
There’s no force push required
The history of your own commits is preserved
Git Repository Setup minimizes merge conflicts during merge operations via .gitattributes