▶️ It only takes about 5 minutes to get up and running with ArchiveBox.
ArchiveBox officially supports macOS, Ubuntu/Debian, and BSD, but likely runs on many other systems. You can run it on any system that supports Docker, including Windows (using Docker in WSL2).
If you want to use Docker or Docker Compose to run ArchiveBox, see the [[Docker]] page.
1. Set up ArchiveBox¶
We recommend using Docker because it has all the extractors and dependencies working out-of-the-box:
# first make sure you have docker: https://docs.docker.com/get-docker/ # then run this to get started with a collection in the current directory docker run -v $PWD:/data -it archivebox/archivebox init # alternatively, install ArchiveBox and its dependencies directly on your system without docker # (script prompts for user confirmation before installing anything) curl https://raw.githubusercontent.com/ArchiveBox/ArchiveBox/master/bin/setup.sh | sh # or follow the manual setup instructions if you don't like using curl | sh
(The above are shell commands to run. If you’re not used to those, consult your operating system’s manual for how to run a terminal emulator.)
For more details, including the manual setup and docker instructions, see the [[Install]] page.
2. Get your list of URLs to archive¶
Follow the links here to find instructions for exporting a list of URLs from each service.
- Reddit Saved Posts
- Chrome Bookmarks
- Firefox Bookmarks
- Safari Bookmarks
- Opera Bookmarks
- Internet Explorer Bookmarks
- Chrome History:
- Firefox History:
- Safari History:
- Other File or URL: (e.g. RSS feed url, text file path) pass as second argument in the next step
(If any of these links are broken, please submit an issue and I’ll fix it)
3. Add your URLs to the archive¶
Pass in URLs directly, import a list of links from a file, or import from a feed URL. All via stdin:
# if using docker docker run -v $PWD:/data -it archivebox/archivebox add 'https://example.com' # or if not using docker archivebox add 'https://example.com' # any text containing links can also be passed in via stdin (works with docker as well) curl https://getpocket.com/users/example/feed/all | archivebox add
./index.html to view your archive. (favicons will appear next to each title once they have finished downloading)
You can also use the interactive Web UI to view/manage/add links to your archive:
# with docker: docker run -v $PWD:/data -it -p 8000:8000 archivebox/archivebox # or without docker: archivebox server open http://127.0.0.1:8000
- Read [[Usage]] to learn about the various CLI and web UI functions
- Read [[Configuration]] to learn about the various archive method options
- Read [[Scheduled Archiving]] to learn how to set up automatic daily archiving
- Read [[Publishing Your Archive]] if you want to host your archive for others to access online
- Read [[Troubleshooting]] if you encounter any problems