From cdbc2a14a3dbc5f1be326a89894ce07ed742817d Mon Sep 17 00:00:00 2001 From: Nick Sweeting Date: Tue, 12 Apr 2022 18:08:46 -0400 Subject: [PATCH] Updated Upgrading or Merging Archives (markdown) --- Upgrading-or-Merging-Archives.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/Upgrading-or-Merging-Archives.md b/Upgrading-or-Merging-Archives.md index 02e7735..f7566d6 100644 --- a/Upgrading-or-Merging-Archives.md +++ b/Upgrading-or-Merging-Archives.md @@ -37,7 +37,10 @@ More info: --- -### Upgrading with Docker Compose +### Upgrading with Docker Compose ⭐️ + +Using Docker Compose is recommended because it makes upgrading a breeze! ✨ +Pulling and running the latest version automatically upgrades the ArchiveBox collection and all of ArchiveBox's internal dependencies. ```bash cd ~/archivebox # or wherever your data folder is @@ -49,6 +52,8 @@ docker-compose up # collection will be automatically upgraded as it starts ### Upgrading with plain Docker +Upgrading with plain Docker is similar to the process with Docker Compose, but you have to run `archivebox init` manually at the end to finish the process. + ```bash docker ps -a -q --filter ancestor=archivebox/archivebox # find any currently running archivebox containers docker kill # stop any currently running archivebox versions @@ -61,6 +66,8 @@ docker run -v $PWD:/data -it -p 8000:8000 archivebox/archivebox server ### Upgrading with a package manager +Package manager releases take a lot of effort to maintain ([contributions welcome!](https://github.com/ArchiveBox/ArchiveBox/wiki/Donations)) and sometimes lag behind the Docker releases. We make a best effort to have the latest release available through all channels within a reasonable timeframe. + ```bash cd ~/archivebox # or wherever your data folder is killall archivebox # stop the currently running archivebox version @@ -71,10 +78,14 @@ pip install --upgrade archivebox brew upgrade archivebox # or apt install --upgrade archivebox -# or +# or with the optional auto-installer script curl -sSL 'https://get.archivebox.io' | sh archivebox init # run init to upgrade the collection to the latest version + +archivebox update --index-only # optionally force an update of the snapshot index files (normally done lazily, see issue #962 for more info) + +archivebox status # check that everything succeeded ``` *More detailed instructions here: https://github.com/ArchiveBox/ArchiveBox#-package-manager-setup* @@ -124,7 +135,7 @@ Two or more existing ArchiveBox collection dirs can be merged together by simply cd /path/to/archivebox_new archivebox status - # optionally update the snapshot index.{json,html} files (normally done lazily) + # optionally force an update of the snapshot index files (normally done lazily) archivebox update --index-only ``` For more information about why Snapshot index files are usually updated lazily, see: https://github.com/ArchiveBox/ArchiveBox/issues/962