diff --git a/README.md b/README.md
index f1adfe3f..e9e32977 100644
--- a/README.md
+++ b/README.md
@@ -121,46 +121,48 @@ ls ./archive/*/index.json # or browse directly via the filesyste
docker-compose
on macOS/Linux/Windows ✨ (highly recommended)
docker-compose.yml
file into a new empty directory somewhere.
curl -O 'https://raw.githubusercontent.com/ArchiveBox/ArchiveBox/master/docker-compose.yml'
-docker-compose run archivebox init --setup
docker-compose run archivebox init --setup
docker-compose up
docker
on macOS/Linux/Windows# create a new empty directory and initalize your collection (can be anywhere)
-mkdir ~/archivebox && cd ~/archivebox
+
+- Install Docker on your system (if not already installed).
+- Create a new empty directory and initalize your collection (can be anywhere).
+
mkdir ~/archivebox && cd ~/archivebox
docker run -v $PWD:/data -it archivebox/archivebox init --setup
-
-Optional: Start the server then open the web UI http://127.0.0.1:8000.
+
+- Optional: Start the server then open the web UI http://127.0.0.1:8000.
docker run -v $PWD:/data -p 8000:8000 archivebox/archivebox
+
+
-See below for more usage examples using the CLI, Web UI, and filesystem/SQL/Python to add URLs and manage your archive.
+See below for more usage examples using the CLI, Web UI, or filesystem/SQL/Python manage your archive.
apt
on Ubuntu/Debianapt
sources automatically:
sudo apt install software-properties-common
sudo add-apt-repository -u ppa:archivebox/archivebox
@@ -172,62 +174,70 @@ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C258F79DCC02E369
sudo apt update
-Then install the apt
package and continue the setup:
+Then install the apt
package:
sudo apt install archivebox
-
-# create a new empty directory and initalize your collection (can be anywhere)
-mkdir ~/archivebox && cd ~/archivebox
+
+mkdir ~/archivebox && cd ~/archivebox
archivebox init --setup # if any problems, install with pip instead
-
-Optional: Start the server then open the web UI http://127.0.0.1:8000.
+archivebox server 0.0.0.0:8000
-
+brew
on macOS# install the archivebox package using homebrew
-brew install archivebox/archivebox/archivebox
-
-# create a new empty directory and initalize your collection (can be anywhere)
-mkdir ~/archivebox && cd ~/archivebox
+
+- Install Homebrew on your system (if not already installed).
+- Install the archivebox package using homebrew.
+
brew install archivebox/archivebox/archivebox
+
+
+- Create a new empty directory and initalize your collection (can be anywhere).
+
mkdir ~/archivebox && cd ~/archivebox
archivebox init --setup # if any problems, install with pip instead
-
-Optional: Start the server then open the web UI http://127.0.0.1:8000.
+
+- Optional: Start the server then open the web UI http://127.0.0.1:8000.
archivebox server 0.0.0.0:8000
+
+
-See below for more usage examples using the CLI, Web UI, and filesystem/SQL/Python to add URLs and manage your archive.
+See below for more usage examples using the CLI, Web UI, or filesystem/SQL/Python manage your archive.
pip
on any other platforms (some extras must be installed manually)# install the archivebox package using pip3
-pip3 install archivebox
-
-# create a new empty directory and initalize your collection (can be anywhere)
-mkdir ~/archivebox && cd ~/archivebox
+
+- Install Python >= v3.7 and Node >= v14 on your system (if not already installed).
+- Install the archivebox package using pip3.
+
pip3 install archivebox
+
+
+- Create a new empty directory and initalize your collection (can be anywhere).
+
mkdir ~/archivebox && cd ~/archivebox
archivebox init --setup
# Install any missing extras like wget/git/ripgrep/etc. manually as needed
-
-Optional: Start the server then open the web UI http://127.0.0.1:8000.
+
+- Optional: Start the server then open the web UI http://127.0.0.1:8000.
archivebox server 0.0.0.0:8000
+
+
-See below for more usage examples using the CLI, Web UI, and filesystem/SQL/Python to add URLs and manage your archive.
+See below for more usage examples using the CLI, Web UI, or filesystem/SQL/Python manage your archive.