From 4005341083146a02cc621a913b35deba41a8b6d0 Mon Sep 17 00:00:00 2001
From: Chris <github.account@chrigel.net>
Date: Tue, 27 Dec 2022 15:23:57 +0100
Subject: [PATCH] Add make and docker-compose for local paperless instance

---
 Makefile                |  2 ++
 README.md               | 20 ++++++++++++++++++
 test/docker-compose.yml | 47 +++++++++++++++++++++++++++++++++++++++++
 test/local.mk           | 12 +++++++++++
 4 files changed, 81 insertions(+)
 create mode 100644 test/docker-compose.yml
 create mode 100644 test/local.mk

diff --git a/Makefile b/Makefile
index 30eda83..506c7d6 100644
--- a/Makefile
+++ b/Makefile
@@ -19,6 +19,8 @@ include Makefile.vars.mk
 # Following includes do not print warnings or error if files aren't found
 # Optional Documentation module.
 -include docs/docs.mk
+# Optional local env module.
+-include test/local.mk
 
 .PHONY: help
 help: ## Show this help
diff --git a/README.md b/README.md
index 14b2e87..652edbd 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,22 @@
 # paperless-cli
 CLI tool to interact with paperless-ngx remote API
+
+
+## Development
+
+### Requirements
+
+- go
+- docker
+- docker-compose (if running local test instance of paperless-ngx)
+- goreleaser (if building deb/rpm packages locally)
+
+### Build
+
+Run `go run . --help` to directly invoke the CLI for testing purposes.
+Run `make help` to see a list of available targets.
+
+Commonly used:
+
+- `make build`: Build the project
+- `make local-install`: Start paperless-ngx in docker-compose (`http://localhost:8008`, user `admin:admin`)
diff --git a/test/docker-compose.yml b/test/docker-compose.yml
new file mode 100644
index 0000000..60219fd
--- /dev/null
+++ b/test/docker-compose.yml
@@ -0,0 +1,47 @@
+# docker-compose file for running paperless from the Docker Hub.
+# This file contains everything paperless needs to run.
+# Paperless supports amd64, arm and arm64 hardware.
+#
+# All compose files of paperless configure paperless in the following way:
+#
+# - Paperless is (re)started on system boot, if it was running before shutdown.
+# - Docker volumes for storing data are managed by Docker.
+# - Folders for importing and exporting files are created in the same directory
+#   as this file and mounted to the correct folders inside the container.
+# - Paperless listens on port 8000.
+#
+# SQLite is used as the database. The SQLite file is stored in the data volume.
+#
+# To install and update paperless with this file, do the following:
+#
+# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
+#   and '.env' into a folder.
+# - Run 'docker-compose pull'.
+# - Run 'docker-compose run --rm webserver createsuperuser' to create a user.
+# - Run 'docker-compose up -d'.
+#
+# For more extensive installation and update instructions, refer to the
+# documentation.
+
+version: "3.4"
+services:
+  broker:
+    image: docker.io/library/redis:7
+    restart: unless-stopped
+    volumes:
+      - redisdata:/data
+
+  webserver:
+    image: ghcr.io/paperless-ngx/paperless-ngx:latest
+    restart: unless-stopped
+    depends_on:
+      - broker
+    ports:
+      - "8008:8000"
+    environment:
+      PAPERLESS_REDIS: redis://broker:6379
+      PAPERLESS_ADMIN_USER: admin
+      PAPERLESS_ADMIN_PASSWORD: admin
+
+volumes:
+  redisdata:
diff --git a/test/local.mk b/test/local.mk
new file mode 100644
index 0000000..66c3095
--- /dev/null
+++ b/test/local.mk
@@ -0,0 +1,12 @@
+compose_file = test/docker-compose.yml
+compose_project = paperless-cli
+
+clean_targets += local-uninstall
+
+.PHONY: local-install
+local-install: ## Install paperless-ngx in docker-compose
+	docker-compose -f $(compose_file) -p $(compose_project) up -d
+
+.PHONY: local-uninstall
+local-uninstall: ## Uninstall paperless-ngx in docker-compose
+	docker-compose -f $(compose_file) -p $(compose_project) rm --force --stop -v