Your Name
494eae2bdf
- new bin/pos-usb-server: flag-style control of usbsrv (--ls, --share, --unshare, --auto-share, --callback, --close-callback, --auto-connect, --disconnect, --nickname, --timeout, --port, --info, --version); interactive prompts fall back to args; command -v usbsrv guard - wire into bin/pos: usb category, example, INTERACTIVE_CMDS - completions: usb-server flag completion - docs: POS.md usb section, AGENT_Context tree/dispatch/table, README - fix: add pos-network-hotspot to no-common.sh list (was omitted) - fix: stale pos-docker-compose line count 317 -> 363 - fix: DEV.md/AGENT_Context note non-apt deps (command -v guard, not PACKAGES) - fix: document INTERACTIVE_CMDS all-or-nothing per-script trade-off - fix: usage() shows docker health (was missing from cheat-sheet)
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
posCLI: network, Docker (compose + vbox VMs), media, system, SSH, USB, and communication (Telegram) tools - Wi-Fi hotspot tools (
create_ap,wihotspot-gui) viapos network hotspot - 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 |