git clone https://github.com/ArchiveBox/ArchiveBox && cd ArchiveBox
ARCHIVEBOX_IMAGE=archivebox/archivebox:dev docker compose up -d

Highlights

• 🔌 New plugin system split out into abx-plugins
  The extractor/plugin catalog now lives in github.com/ArchiveBox/abx-plugins, with per-plugin config, dependencies, hooks, docs, and install metadata.

• ⚡ New one-shot CLI powered by abx-dl
  ArchiveBox now builds on the standalone downloader at github.com/ArchiveBox/abx-dl, so plugin-based archiving can run inside ArchiveBox or independently as a focused CLI.

• 🧱 No more pluggy; new event-driven runtime
  v0.9.x replaces the old pluggy-style in-process plugin system with an event-driven, append-only-log flow. This gives us cleaner resumability, auditability, and a path toward future browser extension capture, distributed workers, and p2p sync.

• 🗃️ Safer data layout and migrations
  The new layout keeps user-owned snapshot/crawl data under data/archive/users/{username}/..., creates crawl records for migrated snapshots, and preserves legacy ArchiveResult data instead of rediscovering everything from slow filesystem scans.

• 🖥️ Improved browser isolation and output serving
  Chrome-based extractors now use crawl-scoped browser sessions, cleanup cloned profiles after each crawl, and serve snapshot outputs through web.archivebox.io / snap-*.archivebox.io style isolation for safer replay.

• 🧭 Tons of UI, CLI, REST API, and database improvements
  Faster snapshot/admin list views, better live progress visibility, improved ArchiveResult detail pages, cleaner REST API paths, and more durable Process/Crawl/Snapshot database state.

What's Changed

• 🔌 Extractor plugins moved into abx-plugins, with generated plugin docs at archivebox.github.io/abx-plugins.
• ⚡ Archiving execution now goes through abx-dl, which can also be used directly:

  uvx abx-dl --plugins=title,screenshot,singlefile 'https://example.com'

• 🧾 Runtime execution now writes structured append-only JSONL records for Crawls, Processes, Snapshots, and ArchiveResults.
• 🔄 Migrations now preserve legacy Snapshot, Tag, ArchiveResult, and filesystem output data across 0.7.x / 0.8.x → 0.9.x upgrades.
• 📁 Heavy crawl/snapshot data stays under data/archive/users/... for Docker volume compatibility.
• 🌐 Added subdomain-aware replay for public web, admin, API, and isolated snapshot hosts.
• 🔒 Added stricter public/admin/API separation and safer default demo deployment options, including disabling public add flows by default.
• 🧩 Browser extractors now share crawl-scoped Chrome sessions and centralize profile cleanup / lock handling through chrome_utils.js.
• 📸 SingleFile, screenshot, DOM, readability, media, git, gallery, forum, and other extractors now run as plugin hooks with explicit outputs.
• 🛠️ Improved archivebox add, archivebox run, archivebox update, archivebox version, archivebox status, and dependency install flows.
• 🚀 Docker image now includes the new unified runtime stack, with Sonic search managed inside the main container.
• 🧪 Validated against large migrated collections, including the public demo dataset, with resumable migration behavior and preserved DB/file outputs.

Helpful related projects and resources:

• SingleFile for self-contained HTML captures
• yt-dlp for media extraction
• gallery-dl for gallery/media sites
• Django Ninja for the REST API
• Sonic for lightweight search indexing

Full Changelog: v0.8.5-rc...v0.9.31-rc

This is an update for the archivebox/archivebox:latest Docker container's internal dependencies and the 0.7.x package metadata/lockfiles.

• chromium v147 (via playwright==1.59.0)
• Chrome for Testing version validation fixed for Playwright Chromium builds
• Node.js -> v24.15.0
• gosu -> v1.19
• yt-dlp -> 2026.03.17
• single-file -> v2.0.83
• curl, wget, git, ripgrep, ffmpeg
• Python dependencies bumped (except for Django, which is still limited to >=3.1.3,<3.2)

Run archivebox version after updating and make sure any manually-installed system dependencies are up to date. Always back up your archive before upgrading.

Full Changelog: v0.7.3...v0.7.4

This is just an update for the archivebox/archivebox:latest Docker container's internal dependencies.

• python, node
• chrome -> v131 ⭐️
• curl
• wget
• yt-dlp -> 2024.12.x ⭐️
• single-file -> v1.1.54 ⭐️ (this update should help fix many archiving issues reported in v0.7.2)
• readability
• ripgrep
• sonic -> archivebox/sonic:latest
• git

There is no change to any of the Python code so no need to pip update to this version if you are not using Docker.
Run archivebox version if not using Docker and make sure any of your manually-installed dependencies are up-to-date .
Always make sure to back up your archive.

Full Changelog: v0.7.2...v0.7.3

Also I just got a new job recently and I'm about to have a kid so no promises on stable release schedule anytime soon, sorry!

gzip -k ./data/index.sqlite3         # do this at least 🙏
zip -r data.bak.zip data             # OR even better: backup the entire data dir

docker pull archivebox/archivebox:0.8.5rc51
# OR
pip install 'git+https://github.com/ArchiveBox/ArchiveBox@v0.8.5rc51'

archivebox install         # make sure all package and runtime dependencies are installed & available
archivebox init            # run data migrations (slow, theoretically safe to Ctrl+C and resume, but try not to)
archivebox version         # check that everything updated properly and dependencies are installed
archivebox status          # see a health report on the collection index & snapshot directories

Highlights

What's Changed

• 📦 Deprated apt and brew install methods in favor of pip + new archivebox install cmd
• 🌈 Much improved archivebox help, archivebox version, and archivebox shell CLI interfaces
• ⚡️ Massive speedups to binary detection and loading at startup time
• ✍️ New Machine, NetworkInterface, and InstalledBinary models keep an audit log of host environment changes and health
• Many other bugfixes, speedups, and internal architecture improvements
• Move novnc web-ui to 8081 by @agowa in #1522
• Add OpenContainer Image Format Annotations as Labels to Docker Image by @mpgirro in #1525

New Contributors

• @agowa made their first contribution in #1522
• @mpgirro made their first contribution in #1525

Full Changelog: v0.8.4-rc...v0.8.5-rc

Highlights

• 🪵 moved to proper event-driven task system huey + django-huey-monitor
• 🦸‍♂️ integrated supervisord to manage bg workers
• 📦 integrated ansible/pyinfra (an ansible alternative) to install subdependency packages at runtime
• ⚡️ continued switching from runserver to proper Channels + Daphne ASGI
• 🧩 lots more plugins!

Full Changelog: v0.8.3-rc...v0.8.4-rc

Highlights

• New Admin action buttons text should make it clearer what the butons do
• Adding new URLs / clicking action buttons now runs task in a BG thread instead of running syncronously (and often timing out)
• Added ability to click "View on site" from any object in admin to go directly to viewing the content
• Switched archivebox server from using runserver to a proper daphne ASGI server
• Added HTTP byte range request support (allows you to seek to the middle of a big .mp4 without downloading the whole thing)
• Added ability to regenerate ABIDs on objects that have gone out of sync
• New plugin system architecture is coming along, standard API for hooks now available in plugantic/base_hook.py
• improved CLI logging output using rich for pretty colors and nicer tracebacks
• improved HTTP request logging to filter out noisy 404/304/200 lines
• renamed .created -> .created_at, .modified -> .modified_at, .added -> .bookmarked_at, .updated -> .downloaded_at
• allow accessing admin change pages, API records, and archive contents by both ABID and ID (UUID)
• add ruff linting and lots of type hint improvements with pydantic
• improve auth and CSRF security for the new REST API (cookies no longer work for API auth, a token is appended to URLs instead)
• bump default USER_AGENT settings to chrome v128, bump yt-dlp, singlefile, etc. versions
• lots of other small fixes, speedups, and improvements!

Full Changelog: v0.8.2-rc...v0.8.3-rc

Changelog: v0.8.0-rc...v0.8.2-rc

WIP ALPHA pre-release for the upcoming ArchiveBox v0.8 release.

Highlights

• New REST API built with django-ninja (thanks @Brandl!)
• New ability to send outgoing webhooks triggered by archiving events
• new support for S3/B2/Google Drive/etc. remote storage using Docker + rclone
• new ability to manage ArchiveBox config in Admin UI (read-only for now, ability to edit coming soon...)
• new noVNC remote viewing support for ArchiveBox browser (grab the updated docker-compose.yml first!)
• upgraded to Django 5.0 internally (thanks @jimwins!)
• add new *_EXTRA_ARGS options (thanks @benmuth!) and new unified USER_AGENT option
• add new generic_jsonl parser (thanks @jimwins!)
• switch to feedparser for RSS parsing (thanks @jimwins!)
• remember Snapshot detail page header expanded/collapsed state

COMING SOON: new sci-dl scientific paper downloader being worked on by @benmuth

New Contributors

• @Brandl made their first contribution in #1397
• @tqobqbq made their first contribution in #1396
• @gnattu made their first contribution in #1312
• @speerer made their first contribution in #1323
• @neel-suthar made their first contribution in #1330
• @jimwins made their first contribution in #1365
• @naoph made their first contribution in #1372
• @rdela made their first contribution in #1374
• @n-hebert made their first contribution in #1382

Full Changelog: v0.7.2...v0.8.0-rc

Get this release via pip, docker, brew, or dpkg (apt & brew releases are delayed).

# Get it with Pip on any OS (`amd64`, `arm64`, `arm/v7`)
pip install --upgrade 'archivebox==0.7.2'`

# Get it with Docker on any OS (`amd64`, `arm64`, `arm/v7`)
docker pull archivebox/archivebox:0.7.2

# Get it with brew on macOS (`amd64`, `arm64`)
brew tap archivebox/archivebox
brew install archivebox
pip install --upgrade 'archivebox==0.7.2'`

# Get it with apt on Ubuntu/Debian based systems (`any`)
wget 'https://github.com/ArchiveBox/debian-archivebox/raw/main/archivebox-0.7.1.deb'
apt install ./archivebox-0.7.1.deb
# OR
dpkg -i ./archivebox-0.7.1.deb

# then run pip install after
pip install --upgrade 'archivebox==0.7.2'`

<sup>Note: this is not packaged using "proper" debian techniques like 0.6.2 was, instead it's just a wrapper for executing pip install archivebox w/ a few extras. This is because ArchiveBox relies on some binary and dynamic dependencies (node, chrome, playwright, ffmpeg, yt-dlp, etc.) which aren't allowed in Debian packages.

(Launchpad apt ppa & brew updates coming eventually, packaging all the vendored binaries that archivebox depends on has gotten harder lately)</sup>

# Then run this to upgrade an existing collection data dir to 0.7.2
cd ~/path/to/data/dir
archivebox init

What's Changed

• add --tag=tag1,tag2,tag3 support to archivebox schedule command
• allow PGID=0 root-group ownership of data dir (but PUID=0 is still not allowed)
• improve error messages, hints, and logging about permissions issues in Docker
• notify users when new ArchiveBox version is available on Github (thanks @benmuth!)
• bump dependency versions (yt-dlp, chrome, readability, node, python)
• warn when Docker / or /data volume mounts don't have any space available
• limit to compatible python version to >= 3.8 and <= 3.11

Bug Fixes

• fix action buttons in Snapshot admin page not showing up correctly
• tag links immediately in first stage of archivebox add instead of at the end (so that imports that are paused or interrupted still get tagged correctly)
• fix config variables in CHROME_USER_AGENT format string not getting interpolated properly
• switch readability to prefer Chrome DOM dumps for article text instead of singlefile (because singlefile output is often huge and crashes readability/times out)
• make Docker image smaller by removing unneeded docs files
• better current version detection and remove annoying +editable string and also add BUILD_TIME
• fix /browsers/* does not exist warning on startup

Get this release via pip, docker, brew, or dpkg (apt ppa update delayed).

# Get it with Pip on any OS (`amd64`, `arm64`, `arm/v7`)
pip install --upgrade 'archivebox==0.7.1'`

# Get it with Docker on any OS (`amd64`, `arm64`, `arm/v7`)
docker pull archivebox/archivebox:0.7.1

# Get it with brew on macOS (`amd64`, `arm64`)
brew tap archivebox/archivebox
brew install archivebox

# Get it with apt on Ubuntu/Debian based systems (`any`)
wget 'https://github.com/ArchiveBox/debian-archivebox/raw/main/archivebox-0.7.1.deb'
apt install ./archivebox-0.7.1.deb
# OR
dpkg -i ./archivebox-0.7.1.deb

<sup>Note: this is not packaged using "proper" debian techniques like 0.6.2 was, instead it's just a wrapper for executing pip install archivebox w/ a few extras. This is because ArchiveBox relies on some binary and dynamic dependencies (node, chrome, playwright, ffmpeg, yt-dlp, etc.) which aren't allowed in Debian packages.

(Launchpad apt ppa update coming eventually, packaging for apt has gotten harder lately)</sup>

# Then run this to upgrade an existing collection data dir to 0.7.1
cd ~/path/to/data/dir
archivebox init

What's Changed

Lots of bugfixes, speedups, and small convenience features.

• fix bookmarklet script by @dryrain39 in #708
• point to master image, not latest by @FiddlyRumpus in #739
• Docs: Improve spelling on readme by @Namdrib in #766
• Exempt /add route from CSRF by @tjhorner in #777
• Bump ws from 5.2.2 to 5.2.3 by @dependabot in #784
• Discard Referer header from iframe and link to original URL by @Inndy in #799
• Update setup.sh in #804
• Fix Pinboard RSS parsing valid links as None by @overhacked in #822
• healthcheck endpoint by @ajgon in #873
• Update README.md by @adamwolf in #884
• Fixes Add button behavior on Safari by @adamwolf in #886
• Tweak JS so Safari can choose admin actions by @adamwolf in #885
• Avoid KeyError on Pocket API parser by @bltavares in #843
• (#847) Decode error output hints to string if needed by @TheCakeIsNaOH in #904
• Change logfile open to write mode only by @tuupola in #906
• Fix #725 - correctly parse tags on json import by @hannah98 in #908
• Bump ansi-regex from 5.0.0 to 5.0.1 by @dependabot in #910
• Bump jszip from 3.6.0 to 3.7.1 by @dependabot in #909
• Added TAG_SEPARATOR_PATTERN option for splitting tags by @hannah98 in #911
• Fix typo: volumes section in docker-compose.yml should use array notation by @akhilleusuggo in #918
• Fix broken URI fragment in README.md by @xfq in #942
• Fix typo in README.md by @hyfen in #932
• Fix bin_version: set LANG=C when calling executables to avoid parsing localized output by @pellaeon in #936
• Fix arch installation command by @CrazyPython in #923
• Update pywb entrypoint by @kusold in #961
• Fix missing input redirection in a hint text by @rossvor in #967
• improve title extractor by @prnake in #924
• Bump node-fetch from 2.6.1 to 2.6.7 by @dependabot in #969
• Add PikaPods as commercial hosting option by @m3nu in #974
• Attempted to warn on #984 and #1014 by @turian in #1020
• Method typo? by @EsEnZeT in #1048
• Added standalone dockerfile instructions by @turian in #1023
• Add missing migration 0021 by @turian in #1027
• get setup.sh to run on FreeBSD again (13.x) by @mwestza in #1068
• Warn on broken steps, use yt-dlp to avoid youtube-dl errors, and don't crash on bad UTF-8 by @turian in #1026
• Add SINGLEFILE_ARGS to control single-file arguments by @notevenaperson in #1021
• Support for Reverse Proxy authentication backends (like authelia) by @ajgon in #866
• Bump moment from 2.29.3 to 2.29.4 by @dependabot in #1081
• Install the CodeSee workflow. by @codesee-maps in #1103
• Revert "Install the CodeSee workflow." by @pirate in #1104
• add systemd config by @fa0311 in #1115
• add CHROME_TIMEOUT args by @fa0311 in #1120
• add explicitly specify --headless=new by @fa0311 in #1123
• Add missing closing quote to style attribute by @tejr in #1128
• Fix for Issue #1008 by @dcalano in #1131

New Contributors

Full Changelog: v0.6.2...v0.7.1