Troubleshooting
Nick Sweeting edited this page 2026-09-01 12:03:28 -07:00

Page revisions

32 Commits

Author SHA1 Message Date
Nick Sweeting
14751a4942
Sync documentation from ArchiveBox dev 2026-09-01 12:03:28 -07:00
Nick Sweeting
5937a62bda docs: fix stale config refs across wiki pages + minor typo fixes
Sweep of all prose doc pages to fix references that were stale, wrong,
or pointed at anchors/options that no longer exist in 0.9.x.

Critical (non-functional examples + factual errors):
- All `PUBLIC_SNAPSHOTS=...` examples (Security-Overview, Publishing-
  Your-Archive, Usage) replaced with `PERMISSIONS=public|private`.
- Setting-up-Authentication: drop the "edit CSRF_TRUSTED_ORIGINS in
  archivebox/core/settings.py source" advice (no longer user-settable);
  update auth-permissions list to use PERMISSIONS instead of
  PUBLIC_SNAPSHOTS.
- Security-Overview: SAVE_ARCHIVE_DOT_ORG (with extra underscores)
  was never real; use ARCHIVEDOTORG_ENABLED.
- Docker/Install/Usage: FETCH_TITLE/FETCH_SCREENSHOT/FETCH_PDF/FETCH_DOM
  were never aliases (only FETCH_MEDIA is); replace with real
  <PLUGIN>_ENABLED.
- Troubleshooting: CHROME_BINARY default is `chromium`, not
  `chromium-browser`. Also fixed deprecated `brew cask upgrade
  chromium-browser` -> `brew upgrade --cask chromium`.
- Docker: typo MAX_MEDIA_SIZE -> MEDIA_MAX_SIZE.

Broken Configuration anchors (must be lowercase on GitHub wiki):
- Security-Overview: #FOOTER_INFO / #OUTPUT_PERMISSIONS / #COOKIES_FILE
  -> lowercase.
- Setting-up-Authentication: combined #public_index--public_snapshots--public_add_view
  -> individual #public_index / #public_add_view / #permissions.

Plugin option references now link to abx-plugins:
- CHROME_USER_DATA_DIR / CHROME_BINARY / CHROME_SANDBOX -> /#chrome
- RIPGREP_BINARY -> /#search_backend_ripgrep
- WGET_ENABLED / DOM_ENABLED / SAVE_WGET / SAVE_DOM -> respective anchors
- ARCHIVEDOTORG_ENABLED -> /#archivedotorg
- FAVICON_PROVIDER / FAVICON_ENABLED -> /#favicon
- MEDIA_ENABLED -> /#media

Legacy aliases:
- Scheduled-Archiving: URL_WHITELIST/URL_BLACKLIST -> URL_ALLOWLIST/
  URL_DENYLIST; dropped non-existent `--overwrite` schedule flag.

Dead source links removed:
- Usage: archivebox/main.py + archivebox/config.py (split to cli/ and
  config/common.py).
- Security-Overview: archivebox/extractors/*.py -> plugin anchors.
- Install: dead Configuration#dependency-options and
  Configuration#archive-method-toggles anchors -> abx-plugins reference.

Typo fixes (codespell):
- preferrably -> preferably, necesary -> necessary, Rasberry ->
  Raspberry, sytem -> system, Dissallow -> Disallow, whats -> what's,
  filesytem -> filesystem.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-31 03:29:27 -07:00
Nick Sweeting
040ffd69a8
Merge remote-tracking branch 'docs/master' into HEAD
# Conflicts:
#	Web-Archiving-Community.md
2026-03-15 15:32:46 -07:00
Nick Sweeting
e75956f037 Updated Troubleshooting (markdown) 2025-10-16 16:19:40 -04:00
Nick Sweeting
6d9ec5b4dc Updated Troubleshooting (markdown) 2025-10-16 16:18:39 -04:00
Justin Halliwill
63aa1dad64
added info re: macOS install via pip instead of brew 2025-07-30 21:32:34 -04:00
Nick Sweeting
ebf56ef780 Updated Troubleshooting (markdown) 2024-07-11 19:02:09 -07:00
Nick Sweeting
80908ce4de Updated Troubleshooting (markdown) 2024-07-11 19:01:59 -07:00
Nick Sweeting
da6c1f2c91 Updated Troubleshooting (markdown) 2024-07-11 19:01:38 -07:00
Nick Sweeting
f23abba977
remove references to main branch in favor of stable branch 2024-04-24 16:37:22 -07:00
Nick Sweeting
8938bb7241 Updated Troubleshooting (markdown) 2024-02-29 01:50:45 -08:00
Nick Sweeting
d1f0964adf Updated Troubleshooting (markdown) 2024-02-18 23:51:06 -08:00
Nick Sweeting
0837f914e1 Updated Troubleshooting (markdown) 2024-02-18 18:12:53 -08:00
Nick Sweeting
2458fcb39a Updated Troubleshooting (markdown) 2024-02-18 18:11:34 -08:00
Nick Sweeting
fe4dcb49d3 Updated Troubleshooting (markdown) 2024-02-18 18:05:55 -08:00
Nick Sweeting
974807b6de Updated Troubleshooting (markdown) 2024-02-18 18:05:19 -08:00
Nick Sweeting
496a21e640 Updated Troubleshooting (markdown) 2023-11-08 23:27:22 -08:00
Nick Sweeting
50f34bfe21 Updated Troubleshooting (markdown) 2022-04-12 17:32:29 -04:00
Nick Sweeting
d71595dcf1 Updated Troubleshooting (markdown) 2022-04-12 17:30:36 -04:00
Nick Sweeting
c017710267 Updated Troubleshooting (markdown) 2021-07-07 07:07:43 -04:00
Nick Sweeting
21f608df2e Updated Troubleshooting (markdown) 2021-04-11 03:20:38 -04:00
Nick Sweeting
6c54fca67e update url paths 2020-11-23 02:06:24 -05:00
Nelebh
07d0e09a07 Fix Twitter link 2020-08-12 16:55:01 +02:00
Nick Sweeting
f1b6bf6758 add sphinx documentation setup 2019-04-28 16:45:47 -04:00
Nick Sweeting
4518a57672 Updated Troubleshooting (markdown) 2019-04-16 21:01:10 -04:00
Nick Sweeting
af37c449f2 Updated Troubleshooting (markdown) 2019-03-12 20:43:48 -04:00
Nick Sweeting
fcb9b98d2e Updated Troubleshooting (markdown) 2019-02-27 13:36:50 -05:00
Nick Sweeting
6b904ec83e Updated Troubleshooting (markdown) 2019-01-11 08:10:16 -05:00
Nick Sweeting
10c0b79bff Updated Troubleshooting (markdown) 2019-01-11 08:07:16 -05:00
Nick Sweeting
16ff0ede13 Updated Troubleshooting (markdown) 2019-01-11 08:06:45 -05:00
Nick Sweeting
4d58ab2fe3 Updated Troubleshooting (markdown) 2019-01-11 08:05:16 -05:00
Nick Sweeting
94785d9c12 Created Troubleshooting (markdown) 2018-12-31 19:55:07 -05:00