1 files changed, 35 insertions, 0 deletions

diff --git a/docs b/docs
new file mode 100644
index 0000000..42baa53
--- /dev/null
+++ b/docs
@@ -0,0 +1,35 @@
+## Setup
+
+Both must use --in-pod=false so the torrent container can attach to the VPN container's network.
+Downloads appear in /root/downloads on the host.
+
+    cd /root/mullvad-docker && podman compose --in-pod=false up -d
+    cd /root/mullvad-docker/torrent && podman compose --in-pod=false up -d
+
+## Shell into container
+
+    podman exec -it torrent bash
+
+## aria2p commands
+
+    # Add downloads
+    aria2p add "magnet:?xt=urn:btih:..."
+    aria2p add "https://example.com/file.zip"
+    aria2p add /path/to/file.torrent
+
+    # Monitor
+    aria2p show                # list all downloads
+    aria2p top                 # live TUI
+
+    # Control
+    aria2p pause <GID>         # pause one
+    aria2p resume <GID>        # resume one
+    aria2p remove <GID>        # remove one
+    aria2p pause-all
+    aria2p resume-all
+
+    # Cleanup
+    aria2p purge               # clear completed/errored from list
+
+GID is the hex ID from aria2p show.
+