The_Great_Archive/ArchiveBox
1
0
Fork 0
mirror of https://github.com/ArchiveBox/ArchiveBox.git synced 2026-09-12 19:50:57 +05:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

Separate native and Docker upgrade steps

Browse Source
This commit is contained in:
Nick Sweeting 2026-08-01 00:07:04 -07:00
parent 58d517d2d1
commit a041a9d7e7
No known key found for this signature in database
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/Upgrading.md
View File

@ -1,17 +1,21 @@
# Upgrading Versions
```bash
# cd /path/to/your/archivebox/data
# Native uv, apt, or brew install
cd ~/archivebox/data
uv tool install --python 3.13 --upgrade 'git+https://github.com/ArchiveBox/ArchiveBox.git@dev'
# or
docker pull archivebox/archivebox:dev
# upgrade the collection to a new version
archivebox init
archivebox install
archivebox update
archivebox status
# Docker Compose install
cd ~/archivebox
docker compose pull
docker compose run --rm archivebox init
docker compose run --rm archivebox install
docker compose run --rm archivebox update
docker compose up -d
```
@ -28,8 +32,7 @@ archivebox update
---
*Note: It's recommended to only upgrade one major version at a time. e.g. if you're on `v0.4.14`, upgrade to `v0.5.6` next, then `v0.6.3`, and finally `v0.7.1` (as 3 separate steps).
You can specify exact versions with uv like so: `uv tool install --python 3.13 --upgrade archivebox==0.6.3` or with docker `docker pull archivebox/archivebox:0.6.3`. Upgrading directly across multiple major versions may work in some cases, but is not recommended for maximum data safety.*
*Note: It's recommended to only upgrade one major version at a time. Follow each intermediate release's upgrade instructions and Python requirements rather than installing old releases with the current Python version. Upgrading directly across multiple major versions may work in some cases, but is not recommended for maximum data safety.*
---
@ -105,8 +108,9 @@ uv tool install --python 3.13 --upgrade 'git+https://github.com/ArchiveBox/Archi
# or
sudo apt update
sudo apt install --only-upgrade archivebox
# or with the optional auto-installer script
curl -sSL 'https://get.archivebox.io' | sh
# or
brew update
brew upgrade archivebox
archivebox init # run init to upgrade the collection to the latest version
archivebox install # refresh runtime dependencies if needed