From fab9aa353a86604532583d5b2b586784d2bddd45 Mon Sep 17 00:00:00 2001
From: Roland Osborne <roland.osborne@gmail.com>
Date: Fri, 2 Sep 2022 13:02:08 -0700
Subject: [PATCH] adding pizero instructions

---
 doc/pizero.md | 98 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 doc/pizero.md

diff --git a/doc/pizero.md b/doc/pizero.md
new file mode 100644
index 00000000..202d7dcb
--- /dev/null
+++ b/doc/pizero.md
@@ -0,0 +1,98 @@
+# Install Databag on Raspberry Pi Zero (1)
+
+## These instructions assume you have the following setup:
+  - reverse proxy with an assigned hostname and certificate forwarding to your Raspberry Pi
+  - micro usb to ethernet adapter
+  - address reservation on your router
+  - reasonably large micro sd card (~64 GB)
+
+## Step 1: setup the hardware
+  Download the DietPi OS and select the ARMv6 32-bit image:
+    https://dietpi.com/downloads/images/DietPi_RPi-ARMv6-Bullseye.7z
+  Extract the img file with 7-zip
+  Write the img file to the sd card with Rufus
+  Insert the sd card in the pi and turn it on
+
+## Step 2: install the OS
+  SSH into the pi with root:dietpi
+  Watch it update and reboot
+  Install the minimal image
+
+## Step 3: install databag dependencies
+  apt-get -y install curl
+  apt-get -y install net-tools
+  apt-get -y install jq
+  apt-get -y install netcat
+  apt-get -y install unzip
+  apt-get -y install wget
+  apt-get -y install git 
+  apt-get -y install vim 
+  apt-get -y install fail2ban
+  apt-get -y install imagemagick-6.q16
+  apt-get -y install ffmpeg
+  apt-get -y install build-essential
+  apt-get -y install sqlite3
+  apt-get -y install openssh-client
+
+## Step 4: install golang
+  Download the armv6l version:
+    https://go.dev/dl/go1.19.linux-armv6l.tar.gz
+  Extract it to /usr/local
+    tar -C /usr/local -xzf go1.19.linux-armv6l.tar.gz
+
+## Step 5: setup databag paths
+  mkdir -p /var/lib/databag
+  mkdir -p /opt/databag/transform
+  cp /app/databag/net/container/transform/* /opt/databag/transform/
+
+## Step 6: initialize the internal datbase
+  sqlite3 /var/lib/databag/databag.db "VACUUM;"
+  sqlite3 /var/lib/databag/databag.db "CREATE TABLE IF NOT EXISTS 'configs' ('id' integer NOT NULL UNIQUE,'config_id' text NOT NULL,'str_value' text,'num_value' integer,'bool_value' numeric,'bin_value' blob,PRIMARY KEY ('id'));"
+  sqlite3 /var/lib/databag/databag.db "CREATE UNIQUE INDEX IF NOT EXISTS 'idx_configs_config_id' ON 'configs'('config_id');"
+  sqlite3 /var/lib/databag/databag.db "insert into configs (config_id, str_value) values ('asset_path', '/var/lib/databag/');"
+  sqlite3 /var/lib/databag/databag.db "insert into configs (config_id, str_value) values ('script_path', '/opt/databag/transform/');"
+
+## Step 7: clone and build the server
+  mkdir /app
+  cd /app
+  git clone https://github.com/balzack/databag.git
+  cd /app/databag/net/server
+  /usr/local/go/bin/go build databag
+
+## Step 8: download the webapp
+  // because the react toolchain isn't available for the pi zero, the webapp is build in a github action
+  Download webapp.zip from the most recent build:
+    https://github.com/balzack/databag/actions/runs/2981276524
+  SCP webapp.zip into the pi
+  Extract it into the web/build directory
+    mkdir /app/databag/net/web/build
+    unzip webapp.zip -d /app/databag/net/web/build/
+
+## Step 9: launch the server
+  cd /app/databag/net/server
+  nohup /usr/local/go/bin/go run databag
+
+## Step 10: configure the server
+  Open your brower to the pi hostname
+  Click the 'cog' in the upper right
+  Set an admin password
+  Select the 'cog' to bring up the settings modal
+    - set your hostname
+    - set the key to RSA 2048
+    - enable images
+    - disable audio
+    - disable video
+
+## Step 11: create accounts
+  Still in the admin dashboard
+  Click the 'add-user' button
+  Open the link in a new tab
+  Set a username and password
+  Setup your profile
+  Connect with contacts on federated instances
+
+## Step 12: host for your friends and family
+  Back in the admin dashboard
+  Click the 'add-user' and send the link to anyone you want to host
+
+