🔧 add Docker build scaffolding and rootfs 🔧

- add Dockerfile, .dockerignore, .env.scripts, .gitattributes
- add .gitignore and Gitea workflow directory
- add rootfs/ overlay files

Dockerfile
.dockerignore
.env.scripts
.gitattributes
.gitea/
.gitignore
rootfs/

rootfs/root/docker/setup/00-init.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  00-init.sh
+# @@Description      :  script to run init
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/00-init.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/01-system.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  01-system.sh
+# @@Description      :  script to run system
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/01-system.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/02-packages.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  02-packages.sh
+# @@Description      :  script to run packages
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/02-packages.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+if command -v update-ca-certificates >/dev/null 2>&1; then
+  update-ca-certificates
+elif command -v update-ca-trust >/dev/null 2>&1; then
+  update-ca-trust extract
+elif command -v trust >/dev/null 2>&1; then
+  trust extract-compat
+fi
+
+if command -v apt-get >/dev/null 2>&1; then
+  echo "Adding the Adoptium Temurin apt repository"
+  mkdir -p "/etc/apt/keyrings"
+  wget -qO - "https://packages.adoptium.net/artifactory/api/gpg/key/public" | gpg --dearmor >"/etc/apt/keyrings/adoptium.gpg"
+  echo "deb [signed-by=/etc/apt/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print $2}' /etc/os-release) main" >"/etc/apt/sources.list.d/adoptium.list"
+
+  echo "Adding the GitHub CLI apt repository"
+  wget -qO - "https://cli.github.com/packages/githubcli-archive-keyring.gpg" | tee "/etc/apt/keyrings/githubcli-archive-keyring.gpg" >/dev/null
+  chmod go+r "/etc/apt/keyrings/githubcli-archive-keyring.gpg"
+  echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" >"/etc/apt/sources.list.d/github-cli.list"
+
+  apt-get update
+  pkmgr install temurin-17-jdk gh
+
+  echo "Linking JAVA_HOME to a stable path"
+  jdk_dir="$(dirname -- "$(dirname -- "$(readlink -f -- "$(command -v javac)")")")"
+  ln -sfn "$jdk_dir" "${JAVA_HOME:-/opt/jdk-17}"
+fi
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/03-files.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  03-files.sh
+# @@Description      :  script to run files
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/03-files.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+if [ -d "/tmp/bin" ]; then
+  mkdir -p "/usr/local/bin"
+  for bin in "/tmp/bin"/*; do
+    [ -e "$bin" ] || continue
+    name="${bin##*/}"
+    echo "Installing $name to /usr/local/bin/$name"
+    cp -Rf "$bin" "/usr/local/bin/$name"
+    chmod -f +x "/usr/local/bin/$name"
+  done
+fi
+unset bin
+if [ -d "/tmp/var" ]; then
+  for var in "/tmp/var"/*; do
+    [ -e "$var" ] || continue
+    name="${var##*/}"
+    echo "Installing $var to /var/$name"
+    if [ -d "$var" ]; then
+      mkdir -p "/var/$name"
+      cp -Rf "$var/." "/var/$name/"
+    else
+      cp -Rf "$var" "/var/$name"
+    fi
+  done
+fi
+unset var
+if [ -d "/tmp/etc" ]; then
+  for config in "/tmp/etc"/*; do
+    [ -e "$config" ] || continue
+    name="${config##*/}"
+    echo "Installing $config to /etc/$name"
+    if [ -d "$config" ]; then
+      mkdir -p "/etc/$name"
+      cp -Rf "$config/." "/etc/$name/"
+    else
+      cp -Rf "$config" "/etc/$name"
+    fi
+  done
+fi
+unset config
+if [ -d "/tmp/usr" ]; then
+  for share in "/tmp/usr"/*; do
+    [ -e "$share" ] || continue
+    name="${share##*/}"
+    dest="/usr/$name"
+    echo "Installing $share to $dest"
+    mkdir -p "$dest"
+    cp -Rf "$share/." "$dest/"
+  done
+fi
+unset share
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/04-users.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  04-users.sh
+# @@Description      :  script to run users
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/04-users.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/05-custom.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  05-custom.sh
+# @@Description      :  script to run custom
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/05-custom.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+if [ -n "$ANDROID_SDK_ROOT" ]; then
+  echo "Installing the Android SDK cmdline-tools"
+  mkdir -p "$ANDROID_SDK_ROOT"
+  wget -q "https://dl.google.com/android/repository/commandlinetools-linux-${ANDROID_CMDLINE_TOOLS_VERSION}_latest.zip" -O "/tmp/cmdline-tools.zip"
+  unzip -q "/tmp/cmdline-tools.zip" -d "/tmp/cmdline-tools-raw"
+  mkdir -p "$ANDROID_SDK_ROOT/cmdline-tools"
+  mv "/tmp/cmdline-tools-raw/cmdline-tools" "$ANDROID_SDK_ROOT/cmdline-tools/latest"
+  rm -rf "/tmp/cmdline-tools.zip" "/tmp/cmdline-tools-raw"
+
+  echo "Accepting Android SDK licenses"
+  yes | sdkmanager --licenses >/dev/null 2>&1 || true
+
+  echo "Installing Android SDK platforms, build-tools, cmake and NDK"
+  sdk_packages="platform-tools build-tools;${ANDROID_BUILD_TOOLS_VERSION} cmake;${ANDROID_CMAKE_VERSION} ndk;${ANDROID_NDK_VERSION}"
+  IFS=','
+  for platform in $ANDROID_PLATFORM_VERSIONS; do
+    sdk_packages="$sdk_packages platforms;$platform"
+  done
+  unset IFS
+  # shellcheck disable=SC2086
+  sdkmanager $sdk_packages >/dev/null 2>&1
+
+  echo "Pre-warming the Gradle wrapper distribution"
+  dist_dir="${GRADLE_USER_HOME}/wrapper/dists/gradle-${GRADLE_VERSION}-bin"
+  mkdir -p "$dist_dir"
+  wget -q "https://services.gradle.org/distributions/gradle-${GRADLE_VERSION}-bin.zip" -O "$dist_dir/gradle-${GRADLE_VERSION}-bin.zip"
+  unzip -q "$dist_dir/gradle-${GRADLE_VERSION}-bin.zip" -d "$dist_dir"
+  touch "$dist_dir/gradle-${GRADLE_VERSION}-bin.zip.lck"
+fi
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/06-post.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  06-post.sh
+# @@Description      :  script to run post
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/06-post.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+

rootfs/root/docker/setup/07-cleanup.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+##@Version           :  202608141335-git
+# @@Author           :  CasjaysDev
+# @@Contact          :  CasjaysDev <docker-admin@casjaysdev.pro>
+# @@License          :  WTFPL
+# @@Copyright        :  Copyright 2026 CasjaysDev
+# @@Created          :  Fri Aug 14 01:35:28 PM EDT 2026
+# @@File             :  07-cleanup.sh
+# @@Description      :  script to run cleanup
+# @@Changelog        :  newScript
+# @@TODO             :  Refactor code
+# @@Other            :  N/A
+# @@Resource         :  N/A
+# @@Terminal App     :  yes
+# @@sudo/root        :  yes
+# @@Template         :  templates/dockerfiles/init_scripts/07-cleanup.sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# shellcheck disable=SC1001,SC1003,SC2001,SC2003,SC2016,SC2031,SC2090,SC2115,SC2120,SC2155,SC2199,SC2229,SC2317,SC2329
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set bash options
+set -eo pipefail
+if [ "$DEBUGGER" = "on" ]; then
+  echo "Enabling debugging"
+  set -x$DEBUGGER_OPTIONS
+fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Load functions
+__find_and_remove() { [ -z "$1" ] || find "${2:-/etc}" -iname "$1" -exec rm -Rf {} + 2>/dev/null; }
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set env variables
+exitCode=0
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Predefined actions
+if [ -d "/tmp" ]; then rm -Rf "/tmp"/*; fi
+if [ -d "$HOME/.cache" ]; then rm -Rf "$HOME/.cache"; fi
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Main script
+
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# Set the exit code
+exitCode=$?
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+exit $exitCode
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+# ex: ts=2 sw=2 et filetype=sh
+# - - - - - - - - - - - - - - - - - - - - - - - - -
+