Files
mw-pfeddersheim-workstation/docs/tech/setup.md
T
ja 51b5afc8b4 feat(workstation): complete software cleanup and project organization
- Synchronized Ansible roles with removed redundant packages.
- Performed system audit (performance, boot, disk usage).
- Organized home directory by removing 22 clean remote repositories.
- Reclaimed ~21GB of disk space in ~/Projects.
- Retained dirty repositories and those without remote origins for safety.
- Updated documentation (performance tuning, software stack, setup).
- Created NEXT_STEPS.md and documented learnings.
2026-02-27 18:07:54 +01:00

45 lines
1.1 KiB
Markdown

# Workstation Setup Guide
This guide describes how to bootstrap the **mw-pfeddersheim-workstation** infrastructure on a fresh installation.
## Prerequisites
- Linux (Manjaro/Arch Linux)
- Python 3.12+
- Git
## Bootstrap Steps
1. **Clone the Infrastructure Repo**
```bash
mkdir -p ~/infrastructure
cd ~/infrastructure
git clone <repo-url> mw-pfeddersheim-workstation
cd mw-pfeddersheim-workstation
```
2. **Install Ansible**
```bash
sudo pacman -S ansible
```
3. **Configure Secrets**
```bash
# Create a vault password file (do not commit!)
echo "your-strong-password" > ansible/vault_password
# Create secrets file
ansible-vault create ansible/vars/secrets.yml
```
4. **Run the Playbook**
```bash
ansible-playbook -i localhost, -c local --vault-password-file ansible/vault_password ansible/workstation.yml --check
# If check passes:
ansible-playbook -i localhost, -c local --vault-password-file ansible/vault_password ansible/workstation.yml
```
5. **Initialize Maintenance**
```bash
./scripts/maintenance.sh
```