first pass helper script

README.md

@@ -0,0 +1,24 @@
+### Initial SD setup
+1. Write armbian minimal to SD
+2. Copy `not_logged_in_yet` over to allow wifi connection.
+3. SSH in as root with password "1234", NOT the password in `not_logged_in_yet`
+4. After first login, `not_logged_in_yet` will be processed for root and armbian user creds.
+5. Future: `armbian-config` to switch to stable channel updates? NOPE dpkg errors 2026-04
+6. Git clone tinyboard repo as root.
+7. Run aptprimary and autohostname scripts.
+8. Reboot. Test as armbian user with configured passwords.
+9. Set up ssh keys.
+
+
+### VPS Setup:
+
+`apt install rclone fuse
+adduser armbian
+groupadd fuse
+usermod -aG fuse armbian
+sudo sed -i 's/^#user_allow_other/user_allow_other/' /etc/fuse.conf
+`
+
+* setup ssh keys
+
+

aptprimary.sh

@@ -3,6 +3,6 @@
 # Need armbian-config?
 
 apt install -y vim
-
+apt install -y autossh
 apt install -y docker.io docker-cli docker-compose
 usermod -aG docker armbian

hub/rclone-mount@.service

@@ -0,0 +1,23 @@
+#~/.config/systemd/user/rclone-mount@.service
+
+[Unit]
+Description=Rclone mount of %i
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=notify
+ExecStartPre=/usr/bin/mkdir -p %h/mnt/%i
+ExecStart=/usr/bin/rclone mount %i: %h/mnt/%i \
+    --config=%h/.config/rclone/rclone.conf \
+    --vfs-cache-mode writes \
+    --vfs-cache-max-size 256M \
+    --allow-other \
+    --log-level INFO \
+    --log-file /tmp/rclone-%i.log
+ExecStop=/bin/fusermount -u %h/mnt/%i
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target

hubspoke-helper.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+#
+# hubspoke-helper.sh - Manage hub/spoke rclone mounts over reverse SSH
+#
+# This script helps configure and control the two sides:
+#   - Spoke: establishes a reverse SSH tunnel (autossh)
+#   - Hub: mounts the spoke's filesystem via rclone/sftp
+#
+# It expects service template files in:
+#   ./spoke/autossh-tunnel.service
+#   ./hub/rclone-mount@.service
+#
+# Those files can be copied or piped into place by this script.
+
+set -euo pipefail
+
+# ------------------------------------------------------------
+# Configuration (adjust these to your environment)
+# ------------------------------------------------------------
+SPOKE_AUTOSSH_SERVICE_SRC="./spoke/autossh-tunnel.service"
+HUB_RCLONE_SERVICE_SRC="./hub/rclone-mount@.service"
+
+# Default values (can be overridden with environment variables or interactive prompts)
+HUB_USER="${HUB_USER:-armbian}"
+HUB_HOST="${HUB_HOST:-oily.dad}"
+SPOKE_USER="${SPOKE_USER:-armbian}"
+TUNNEL_PORT="${TUNNEL_PORT:-11111}"
+SPOKE_SSH_KEY="${SPOKE_SSH_KEY:-$HOME/.ssh/armbian-brie-202604}"
+RCLONE_REMOTE_NAME="${RCLONE_REMOTE_NAME:-brie-remote}"
+MOUNT_POINT="${MOUNT_POINT:-$HOME/mnt/brie}"
+
+# ------------------------------------------------------------
+# Helper functions
+# ------------------------------------------------------------
+usage() {
+    cat <<EOF
+Usage: $0 {hub|spoke} {action}
+
+Manage hub/spoke rclone setup.
+
+ACTIONS FOR SPOKE:
+  show-cmd      Show the autossh command to run manually
+  install       Install the autossh system service (requires sudo)
+  start         Start the installed service (requires sudo)
+  stop          Stop the installed service (requires sudo)
+  status        Show status of the autossh service
+
+ACTIONS FOR HUB:
+  show-cmd      Show the manual rclone mount command
+  install       Install the rclone user service (no sudo)
+  start         Start the rclone user service
+  stop          Stop the rclone user service
+  status        Show status of the rclone user service
+  mount         Manual foreground mount (for testing)
+  unmount       Unmount manually (fusermount -u)
+
+EXAMPLES:
+  $0 spoke show-cmd
+  $0 spoke install
+  $0 hub install
+  $0 hub start
+EOF
+}
+
+die() {
+    echo "ERROR: $*" >&2
+    exit 1
+}
+
+check_service_file() {
+    local file="$1"
+    if [ ! -f "$file" ]; then
+        die "Service template not found: $file"
+    fi
+}
+
+# ------------------------------------------------------------
+# Spoke actions
+# ------------------------------------------------------------
+spoke_show_cmd() {
+    cat <<EOF
+Run this command manually on the SPOKE to establish the reverse tunnel:
+  autossh -M 0 -NT -o "ServerAliveInterval 60" -o "ServerAliveCountMax 3" \\
+    -R ${TUNNEL_PORT}:localhost:22 -i ${SPOKE_SSH_KEY} ${HUB_USER}@${HUB_HOST}
+EOF
+}
+
+spoke_install() {
+    check_service_file "$SPOKE_AUTOSSH_SERVICE_SRC"
+    echo "Installing autossh system service on SPOKE..."
+    sudo cp "$SPOKE_AUTOSSH_SERVICE_SRC" /etc/systemd/system/autossh-tunnel.service
+    sudo systemctl daemon-reload
+    echo "Service installed. Enable with: sudo systemctl enable autossh-tunnel.service"
+    echo "Start with: sudo systemctl start autossh-tunnel.service"
+}
+
+spoke_start() {
+    sudo systemctl start autossh-tunnel.service
+    echo "Started."
+}
+
+spoke_stop() {
+    sudo systemctl stop autossh-tunnel.service
+    echo "Stopped."
+}
+
+spoke_status() {
+    sudo systemctl status autossh-tunnel.service --no-pager
+}
+
+# ------------------------------------------------------------
+# Hub actions
+# ------------------------------------------------------------
+hub_show_cmd() {
+    cat <<EOF
+Manual rclone mount command on HUB (run in foreground, Ctrl+C to stop):
+  mkdir -p ${MOUNT_POINT}
+  rclone mount ${RCLONE_REMOTE_NAME}: ${MOUNT_POINT} \\
+    --config ${HOME}/.config/rclone/rclone.conf \\
+    --vfs-cache-mode writes \\
+    --allow-other
+EOF
+}
+
+hub_install() {
+    check_service_file "$HUB_RCLONE_SERVICE_SRC"
+    echo "Installing rclone user service on HUB..."
+    mkdir -p "$HOME/.config/systemd/user"
+    cp "$HUB_RCLONE_SERVICE_SRC" "$HOME/.config/systemd/user/rclone-mount@.service"
+    systemctl --user daemon-reload
+    echo "Service installed. Enable with: systemctl --user enable rclone-mount@${RCLONE_REMOTE_NAME}.service"
+    echo "Start with: systemctl --user start rclone-mount@${RCLONE_REMOTE_NAME}.service"
+}
+
+hub_start() {
+    systemctl --user start "rclone-mount@${RCLONE_REMOTE_NAME}.service"
+    echo "Started."
+}
+
+hub_stop() {
+    systemctl --user stop "rclone-mount@${RCLONE_REMOTE_NAME}.service"
+    echo "Stopped."
+}
+
+hub_status() {
+    systemctl --user status "rclone-mount@${RCLONE_REMOTE_NAME}.service" --no-pager
+}
+
+hub_mount() {
+    mkdir -p "$MOUNT_POINT"
+    echo "Mounting in foreground. Press Ctrl+C to unmount."
+    rclone mount "${RCLONE_REMOTE_NAME}:" "$MOUNT_POINT" \
+        --config "${HOME}/.config/rclone/rclone.conf" \
+        --vfs-cache-mode writes \
+        --allow-other
+}
+
+hub_unmount() {
+    fusermount -u "$MOUNT_POINT" 2>/dev/null && echo "Unmounted." || echo "Not mounted or already unmounted."
+}
+
+# ------------------------------------------------------------
+# Main dispatch
+# ------------------------------------------------------------
+if [ $# -lt 2 ]; then
+    usage
+    exit 1
+fi
+
+ROLE="$1"
+ACTION="$2"
+
+case "$ROLE" in
+    spoke)
+        case "$ACTION" in
+            show-cmd)   spoke_show_cmd ;;
+            install)    spoke_install ;;
+            start)      spoke_start ;;
+            stop)       spoke_stop ;;
+            status)     spoke_status ;;
+            *)          die "Unknown action for spoke: $ACTION" ;;
+        esac
+        ;;
+    hub)
+        case "$ACTION" in
+            show-cmd)   hub_show_cmd ;;
+            install)    hub_install ;;
+            start)      hub_start ;;
+            stop)       hub_stop ;;
+            status)     hub_status ;;
+            mount)      hub_mount ;;
+            unmount)    hub_unmount ;;
+            *)          die "Unknown action for hub: $ACTION" ;;
+        esac
+        ;;
+    *)
+        usage
+        exit 1
+        ;;
+esac

spoke/autossh-tunnel.service

@@ -0,0 +1,13 @@
+[Unit]
+Description=AutoSSH tunnel from spoke to hub
+After=network.target
+
+[Service]
+Environment="AUTOSSH_GATETIME=0"
+ExecStart=/usr/bin/autossh -M 0 -NT -o "ServerAliveInterval 60" -o "ServerAliveCountMax 3" -R 11111:localhost:22 -i /home/armbian/.ssh/armbian-brie-202604 armbian@oily.dad
+Restart=always
+RestartSec=10
+User=armbian
+
+[Install]
+WantedBy=multi-user.target