mirror/archivebox
1
0
Fork 0
mirror of https://github.com/pirate/ArchiveBox.git synced 2025-08-15 11:04:17 +02:00
Code Issues Releases Wiki Activity

Updated Upgrading or Merging Archives (markdown)

Nick Sweeting
2022-03-22 20:33:58 -04:00
parent ffc5ab627b
commit 4f490afe97
1 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
Upgrading-or-Merging-Archives.md

@@ -1,8 +1,5 @@
## Upgrade your ArchiveBox collection to a new version ## Upgrade your ArchiveBox collection to a new version
*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.4.2`, then to `v0.5.6` (the latest available minor version for each major version), then from there to `v0.6.3`, not straight from `v0.4.14` -> `v0.6.3`.
You can specify exact versions with pip like so: `pip install 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.*
**✅ Upgrading checklist:** **✅ Upgrading checklist:**
1. Find the version you want to upgrade to on https://github.com/ArchiveBox/ArchiveBox/releases 1. Find the version you want to upgrade to on https://github.com/ArchiveBox/ArchiveBox/releases
@@ -10,9 +7,14 @@ You can specify exact versions with pip like so: `pip install archivebox==0.6.3`
3. **Make a full backup** of your `index.sqlite3` and `archive/` content before upgrading! 3. **Make a full backup** of your `index.sqlite3` and `archive/` content before upgrading!
4. Follow the steps below depending on your setup (repeating as necessary for each major version if upgrading across multiple major versions) 4. Follow the steps below depending on your setup (repeating as necessary for each major version if upgrading across multiple major versions)
ArchiveBox uses the Django migrations system for deterministic, atomic, safe upgrades, so your DB should always be left in a consistent state in the event of a failure or power outage. **ℹ️ Details:**
Open an issue in our bug tracker if you experience any problems. As of v0.4 and above, ArchiveBox uses the Django migrations system for deterministic, atomic, safe upgrades, so your DB should always be left in a consistent state in the event of a failure or power outage.
*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.4.2`, then to `v0.5.6` (the latest available minor version for each major version), then from there to `v0.6.3`, not straight from `v0.4.14` -> `v0.6.3`.
You can specify exact versions with pip like so: `pip install 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.*
💬 [Open an issue](https://github.com/ArchiveBox/ArchiveBox/issues/new/choose) in our bug tracker if you experience any problems.
### With Docker Compose ### With Docker Compose