Files
Linux_post_install/README.md
T
Your Name 54592a5839 docs: reorganize into DOC/ and simplify README
- Move all docs (DEV, AGENT_Context, algorithm) into DOC/ via git mv
- Rewrite root README as short intro + quick start + links into DOC/
- Add per-area reference docs: SCRIPTS (core scripts + libs + features),
  POS (pos CLI + compose config), APPS (picker + catalog), SYSTEMD (units)
- Add DOC/README.md index; fix all cross-references
2026-08-03 02:50:38 -04:00

2.3 KiB
Executable File

Linux_post_install — Personal Bootstrap & Homelab Toolkit

One command turns a bare Debian/Ubuntu install into a fully productive machine.

What is this

After reinstalling Linux you usually need to install packages, set up SSH, configure a firewall, and install apps. This repo automates all of that in one go.

It is a personal toolkit — a bootstrap script, a unified pos CLI for everyday tasks, optional app installers, and self-hosted services via ScaleTail + Tailscale.

What you get:

  • 25+ system packages installed automatically
  • The pos CLI: network, Docker, media, system, SSH, and vbox tools
  • 15 optional desktop apps (VS Code, Brave, OBS, Tailscale, …) — pick what you want
  • 119+ self-hosted services with Tailscale access (Jellyfin, Home Assistant, …)
  • systemd services for SSH agent and boot-time automation
  • Everything lands in /usr/local/bin/ — you can delete the repo after install

Quick Start

git clone https://gitea.skink-platy.ts.net/admin/Linux_post_install.git
cd Linux_post_install
./install.sh              # core: packages + CLI + services + ScaleTail
./install.sh --feature    # also install features/ scripts (asks before overwriting)
./install.sh --apps       # also install optional desktop apps (interactive)
Flag What it does
--feature Install features/ scripts to /usr/local/bin/, sets their flags
--apps Interactive app picker after core install
--full Core install + all apps (non-interactive)
--dry-run Preview without executing
--skip <phase> Skip a phase: preinstall, scripts, postinstall, scalepoint, apps
--steps <spec> Run only specific phases, e.g. --steps 1,3
--no-color Disable colored output

Documentation

Topic Where
Docs index DOC/README.md
Core scripts (installer, libs, features) — how they work + config DOC/SCRIPTS.md
pos CLI reference (all commands, compose config, wrappers) DOC/POS.md
Optional apps (picker + full catalog) DOC/APPS.md
Systemd services & bash completion DOC/SYSTEMD.md
Developer guide (add tools/apps/features) DOC/DEV.md
Algorithm diagrams DOC/algorithm.md