# Quickstart

<div align="center"><img src="https://imgur.zervice.io/ZbHpEf8.jpg" alt="" width="30%"></div>

▶️ *It only takes about 5 minutes to get up and running with ArchiveBox.*

ArchiveBox [officially supports](https://github.com/ArchiveBox/ArchiveBox/wiki/Install#supported-systems) **macOS**, **Ubuntu/Debian**, and **BSD**, but likely runs on many other systems. You can run it on any system that supports **Docker** and/or Python. Windows *is not supported* unless you run it inside Docker Desktop, Docker in WSL2, or WSL2.

For more detailed Docker and Docker Compose-specific instructions, see the \[\[Docker]] page.

***

## 1. Set up ArchiveBox

Follow the [README Instructions](https://github.com/ArchiveBox/ArchiveBox#quickstart) for your platform to get archivebox set up.

## 2. Get your list of URLs to archive

Follow the links here to find instructions for exporting a list of URLs from each service.

* [Pocket](https://github.com/ArchiveBox/pocket-exporter)
* [Pinboard](https://pinboard.in/export/)
* [Instapaper](https://instapaper.zendesk.com/hc/en-us/articles/30080578815245-Import-export-content-from-into-Instapaper)
* [Reddit Saved Posts](https://github.com/csu/export-saved-reddit)
* [Shaarli](https://www.mypersonnaldata.eu/shaarli/doc/Backup,-restore,-import-and-export.html#export-links-as)
* [Unmark.it](http://help.unmark.it/import-export)
* [Wallabag](https://doc.wallabag.org/en/user/import/wallabagv2.html)
* [Chrome Bookmarks](https://support.google.com/chrome/answer/96816?hl=en)
* [Firefox Bookmarks](https://support.mozilla.org/en-US/kb/export-firefox-bookmarks-to-backup-or-transfer)
* [Safari Bookmarks](http://imgur.zervice.io/AtcvUZA.png)
* [Opera Bookmarks](http://help.opera.com/Windows/12.10/en/importexport.html)
* [Internet Explorer Bookmarks](https://support.microsoft.com/en-us/help/211089/how-to-import-and-export-the-internet-explorer-favorites-folder-to-a-32-bit-version-of-windows)
* Chrome History: `./bin/export_browser_history.sh --chrome`
* Firefox History: `./bin/export_browser_history.sh --firefox`
* Safari History: `./bin/export_browser_history.sh --safari`
* 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:

```bash
archivebox add < your_urls.txt

# or if using plain Docker
docker run -v $PWD:/data -it archivebox/archivebox add < your_urls.txt

# or if using Docker Compose
docker compose run -T archivebox add < your_urls.txt

# any text containing URLs can ingested via stdin or as args
curl -fsSL 'https://getpocket.com/users/YOURUSERNAME/feed/all' | archivebox add
archivebox add 'https://example.com'
```

## ✅ Done!

Open `./archive` to view your archive data in the filesystem.

You can also use the interactive Web UI to view/manage/add links to your archive:

```bash
# with plain Docker:
docker run -v $PWD:/data -it -p 8000:8000 archivebox/archivebox

# with Docker Compose:
docker compose up -d

# or without Docker:
archivebox server

open http://127.0.0.1:8000
```

***

**Next Steps:**

```bash
archivebox help   # see info about all the available commands
```

* 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://archivebox.gitbook.io/archivebox-docs/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.