ansible/docs/reference/applications.md
ilia a8c83d6efd
Some checks failed
CI / skip-ci-check (pull_request) Successful in 1m18s
CI / lint-and-test (pull_request) Successful in 1m28s
CI / ansible-validation (pull_request) Failing after 3m4s
CI / secret-scanning (pull_request) Successful in 1m20s
CI / dependency-scan (pull_request) Successful in 1m24s
CI / sast-scan (pull_request) Successful in 2m27s
CI / license-check (pull_request) Failing after 1m22s
CI / vault-check (pull_request) Successful in 2m14s
CI / playbook-test (pull_request) Failing after 2m24s
CI / container-scan (pull_request) Successful in 1m51s
CI / sonar-analysis (pull_request) Failing after 1m17s
CI / workflow-summary (pull_request) Successful in 1m17s
CI: fix vault/markdown/license errors
- Remove ANSIBLE_VAULT_PASSWORD_FILE env (invalid /dev/null)
- Fix markdown table spacing in docs/reference/*.md
- Whitelist Python-2.0 license (argparse dependency)
2026-01-01 16:33:06 -05:00

186 lines
6.4 KiB
Markdown

# Installed Applications Reference
Complete inventory of applications and tools deployed by Ansible playbooks.
## Application Categories
### 🔧 System Tools
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| curl | Command line HTTP client | apt | base |
| wget | Network downloader | apt | base |
| unzip | Archive extraction | apt | base |
| xclip | Clipboard utility | apt | base |
| tree | Directory tree viewer | apt | base |
| net-tools | Network utilities | apt | base |
| jq | JSON processor | apt | base |
| yq | YAML processor | snap | base |
| ripgrep | Fast text search | apt | base |
| fd-find | Fast file finder | apt | base |
### 🔒 Security Tools
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| ufw | Uncomplicated Firewall | apt | ssh |
| fail2ban | Intrusion prevention | apt | monitoring |
| openssh-server | SSH daemon | apt | ssh |
| mailutils | Mail utilities | apt | base |
| nmap | Network scanner | apt | monitoring |
| tcpdump | Packet analyzer | apt | monitoring |
| wireshark-common | Protocol analyzer | apt | monitoring |
### 💻 Development Tools
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| git | Version control | apt | development |
| nodejs | JavaScript runtime | apt | development |
| npm | Node package manager | apt | development |
| build-essential | Compilation tools | apt | development |
| python3 | Python interpreter | apt | development |
| python3-pip | Python package manager | apt | development |
### 🐳 Container Platform
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| docker-ce | Docker Community Edition | docker | docker |
| docker-ce-cli | Docker CLI | docker | docker |
| containerd.io | Container runtime | docker | docker |
| docker-buildx-plugin | Multi-platform builds | docker | docker |
| docker-compose-plugin | Multi-container apps | docker | docker |
### 🖥️ Shell Environment
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| zsh | Z shell | apt | shell |
| tmux | Terminal multiplexer | apt | shell |
| fzf | Fuzzy finder | apt | shell |
| zsh aliases | Minimal alias set (sourced from ~/.zshrc) | file | shell |
### 📊 Monitoring Tools
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| htop | Process viewer | apt | monitoring |
| btop | Modern system monitor | snap | monitoring |
| iotop | I/O monitor | apt | monitoring |
| nethogs | Network usage monitor | apt | monitoring |
| iftop | Bandwidth monitor | apt | monitoring |
| bandwhich | Network utilization | snap | monitoring |
| ncdu | Disk usage analyzer | apt | monitoring |
| dstat | System statistics | apt | monitoring |
| sysstat | Performance tools | apt | monitoring |
| atop | Advanced monitor | apt | monitoring |
| logwatch | Log analyzer | apt | monitoring |
### 🌐 Network Tools
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| tailscale | Mesh VPN client | tailscale | tailscale |
| tailscaled | Tailscale daemon | tailscale | tailscale |
### 🖱️ Desktop Applications
| Package | Description | Source | Role |
| --------- | ------------- | -------- | ------ |
| copyq | Clipboard manager (history/search) | apt | applications |
| evince | PDF viewer | apt | applications |
| redshift | Blue light filter | apt | applications |
## Nice-to-have apps (not installed by default)
These are good add-ons depending on how you use your workstations. Keep them opt-in to avoid bloating baseline installs.
### Desktop / UX
- **flameshot**: screenshots + annotation
- **keepassxc**: local password manager (or use your preferred)
- **syncthing**: peer-to-peer file sync (if you want self-hosted sync)
- **remmina**: RDP/VNC client
- **mpv**: lightweight media player
### Developer workstation helpers
- **direnv**: per-project env var loading
- **shellcheck**: shell script linting
- **jq** / **yq**: JSON/YAML CLI tooling (already in base here, but listing for completeness)
- **ripgrep** / **fd-find**: fast search/find (already in base here)
### Networking / diagnostics
- **wireshark** (GUI) or **wireshark-common**: packet analysis (only if you need it)
- **iperf3**: bandwidth testing
- **dnsutils**: dig/nslookup tools
## Installation by Playbook
### `playbooks/development.yml`
Installs all roles for development machines:
- All system tools
- Development environment
- Docker platform
- Shell configuration
- Monitoring tools
- Tailscale VPN
### `playbooks/local.yml`
Installs for local machine management:
- Core system tools
- Shell environment
- Development basics
### `playbooks/workstations.yml`
Installs baseline for `dev:desktop:local`, and installs desktop apps only for the `desktop` group:
- Workstation baseline (dev + desktop + local)
- Desktop applications (desktop group only)
### `playbooks/maintenance.yml`
Maintains existing installations:
- System updates
- Package cleanup
- Security updates
## Custom Scripts
### System Information
- `/usr/local/bin/monitoring/sysinfo` - System overview dashboard
- `/usr/local/bin/monitoring/netinfo` - Network information
## Package Sources
| Source | Description | Configuration |
| -------- | ------------- | --------------- |
| apt | Debian/Ubuntu packages | System default |
| snap | Snap packages | snapd daemon |
| docker | Docker repository | Docker GPG key + repo |
| tailscale | Tailscale repository | Tailscale GPG key + repo |
| git | Git repositories | Direct clone |
## Services Enabled
| Service | Description | Management |
| --------- | ------------- | ------------ |
| docker | Container runtime | systemctl |
| tailscaled | VPN daemon | systemctl |
| ufw | Firewall | systemctl |
| fail2ban | Intrusion prevention | systemctl |
| sshd | SSH server | systemctl |
| snapd | Snap daemon | systemctl |
| sysstat | System statistics | systemctl |
## Version Management
Most packages are installed from distribution repositories and update with system updates. Exceptions:
- **Docker**: Tracks Docker CE stable channel
- **Node.js**: Latest LTS from NodeSource
- **Tailscale**: Latest stable from Tailscale repository
## Total Count: 65+ Applications
- **System & Security**: 20+ tools
- **Development**: 6+ tools
- **Shell Environment**: 7+ components
- **Monitoring**: 15+ tools
- **Container Platform**: 5 components
- **Desktop Applications**: 6+ apps
- **Network**: 2+ tools
- **Custom Scripts**: 4+ scripts