From 7c3637971571c1b5757d634aa627a91ff96999da Mon Sep 17 00:00:00 2001
From: Colin Woodbury <colin@fosskers.ca>
Date: Mon, 21 Feb 2022 14:18:26 -0800
Subject: [PATCH] docs(docker): basic usage instructions

---
 docker/README.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 docker/README.md

diff --git a/docker/README.md b/docker/README.md
new file mode 100644
index 00000000..dceee74f
--- /dev/null
+++ b/docker/README.md
@@ -0,0 +1,39 @@
+# Aurweb and Docker
+
+The `INSTALL` document details a manual Aurweb setup, but Docker images are also
+provided here to avoid the complications of database configuration (and so
+forth).
+
+### Setup
+
+Naturally, both `docker` and `docker-compose` must be installed, and your Docker
+service must be started:
+
+```sh
+systemctl start docker.service
+```
+
+The main image - `aurweb` - must be built manually:
+
+```sh
+docker compose build aurweb-image
+```
+
+### Starting and Stopping the Services
+
+With the above steps complete, you can bring up an initial cluster:
+
+```sh
+docker compose up
+```
+
+Subsequent runs will be done with `start` instead of `up`. The cluster can be
+stopped with `docker compose stop`.
+
+### Testing
+
+With a running cluster, execute the following in a new terminal:
+
+```sh
+docker compose run test
+```