From 1b65b60c881491cd8f9293c0df08cbee5639cf82 Mon Sep 17 00:00:00 2001
From: KemoNine <kemonine@lollipopcloud.solutions>
Date: Sat, 16 Feb 2019 19:33:11 +0000
Subject: [PATCH] Add portainer docs

---
 services/portainer.md | 73 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 services/portainer.md

diff --git a/services/portainer.md b/services/portainer.md
new file mode 100644
index 0000000..5d8c475
--- /dev/null
+++ b/services/portainer.md
@@ -0,0 +1,73 @@
+# Portainer
+
+A simple, efficient web ui for deploying docker containers.
+
+## Inspiration / Sources
+
+- [https://www.portainer.io/](https://www.portainer.io/)
+- [https://github.com/portainer/portainer](https://github.com/portainer/portainer)
+
+## Adjust firewall to allow access on internal network(s)
+
+``` bash
+
+firewall-cmd --permanent --zone=internal --add-port 9000
+firewall-cmd --permanent --zone=trusted --add-port 9000
+firewall-cmd --reload
+
+```
+
+## Install / Update / Run Script
+
+Setup a generic script that'll auto update Portainer and launch it. You should only run this script at first launch and/or when you're looking for updates.
+
+``` bash
+
+mkdir -p /var/portainer
+
+cat > /root/portainer.sh << EOF
+#!/bin/bash
+
+ARCH=\`arch\`
+if [ \$ARCH == "aarch64" ]
+then
+    ARCH="arm64v8"
+else
+    ARCH="arm32v7"
+fi
+
+docker pull registry.lollipopcloud.solutions/\$ARCH/portainer:latest
+
+docker stop portainer
+docker rm portainer
+
+# Additional port map so can get to portainer w/o caddy
+# Use portainer to deploy our caddy container next
+docker run \\
+    --name portainer \\
+    --restart unless-stopped \\
+    --net docker-private \\
+    --ip 172.30.30.30 \\
+    -p 9000:9000 \\
+    -e TZ=UTC \\
+    -v /var/portainer:/data \\
+    -v /var/run/docker.sock:/var/run/docker.sock  \\
+    registry.lollipopcloud.solutions/\$ARCH/portainer \\
+        --templates http://git.lollipopcloud.solutions/lollipop-docker/portainer/raw/branch/master/templates.\${ARCH}.json
+
+EOF
+
+chmod a+x /root/portainer.sh
+
+```
+
+## Run Traefik
+
+Simply execute ```/root/portainer.sh``` to update/run.
+
+## First Run
+
+1. Navigate to ```https://172.30.30.30:9000``` in your web browser. If it prompts about a self-signed certificate, accept the prompt as valid.
+1. You'll be asked to create an administrative account which should have a good password. This is the main account to login with for deploying services.
+1. You'll be prompted to connect. Select ```Local``` and click ```OK```
+1. Under ```App Templates``` you'll see each of the different services we have setup as templates. If you click on one you can begin deploying services.