Your Name
9a164462e7
gates / consistency-and-conventions (push) Successful in 33s
Architect-approved (C): install.sh now skips+aborts (exit 0) when the installed version equals the current git-derived version, with a --force flag to re-install. Version scheme 0.0cN (N = git commit count) bumps by construction on every commit. - install_version(): derives 0.0c$count via git rev-list; empty when .git absent (gate skipped); INSTALL_VERSION_OVERRIDE presence-check seam for tests (empty override simulates no-git deterministically) - Gate after arg parse, before phases; numeric comparison (strip 0.0c, -eq); messages: 'Already installed (X). Use --force to re-install.' and '(dry-run) Would skip install: already at version X', both exit 0 - flag_set installed_version after 'Bootstrap complete' banner (not in dry-run, even under --force, never on phase failure) - Docs: SCRIPTS.md flag table + gate description, AGENT_Context line count 248->301 + flags + flow diagram, README --force row, tests/README row, AGENT_TODO Done entry Verified: new tests/t-install-version.sh 21 checks (9 contracted cases, real install.sh + hermetic env seams); suite 20 files / 461 checks / 0 fail / 0 skip; make gen byte-idempotent; make check OK; make lint 0 FAIL, 0 WARN; bash -n clean; git diff --check clean; Reviewer APPROVE_WITH_NOTES with 3 mutation disproofs (8/21, 9/21, 4/21 fail)
55 lines
2.8 KiB
Markdown
Executable File
55 lines
2.8 KiB
Markdown
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: AI (Gemini chat), network, Docker (compose + vbox VMs), media, system, SSH, share (USB over network + NFS), communication (Telegram), and entertainment (public-API plugins → Telegram) tools
|
|
- Wi-Fi hotspot tools (`create_ap`, `wihotspot-gui`) via `pos network hotspot`
|
|
- `pos tree` — browse the whole CLI: categories, commands, and subcommands
|
|
- 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, boot-time automation, and a daily Telegram health digest (`pos system health`)
|
|
- Everything lands in `/usr/local/bin/` — you can delete the repo after install
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
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 |
|
|
| `--force` | Re-install even if the version matches |
|
|
| `--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](DOC/README.md) |
|
|
| `pos` HOW-TO guides (recipes + troubleshooting) | [DOC/HOWTO.md](DOC/HOWTO.md) |
|
|
| Core scripts (installer, libs, features) — how they work + config | [DOC/SCRIPTS.md](DOC/SCRIPTS.md) |
|
|
| `pos` CLI reference (all commands, compose config, wrappers) | [DOC/POS.md](DOC/POS.md) |
|
|
| Optional apps (picker + full catalog) | [DOC/APPS.md](DOC/APPS.md) |
|
|
| Systemd services & bash completion | [DOC/SYSTEMD.md](DOC/SYSTEMD.md) |
|
|
| Developer guide (add tools/apps/features) | [DOC/DEV.md](DOC/DEV.md) |
|
|
| Algorithm diagrams | [DOC/algorithm.md](DOC/algorithm.md) |
|