Files
mw-pfeddersheim-workstation/docs/tech/setup.md
T
ja 6dbe59e117 docs: align with satware AG best practices
- Delete deprecated CLAUDE.md
- Create root-level AGENTS.md for AI assistant guidance
- Create SDD constitution in .specify/memory/constitution.md
- Align documentation with PARA structure (docs/product/project-brief.md, docs/tech/stack.md, docs/plans/)
- Add standardized YAML frontmatter to all documentation files
- Update README.md with saTway branding and structure
2026-03-09 11:02:17 +01:00

1.3 KiB

description, tags, last_updated
description tags last_updated
Workstation bootstrapping and setup instructions using Ansible.
setup
bootstrap
ansible
2026-03-09

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

    mkdir -p ~/infrastructure
    cd ~/infrastructure
    git clone https://git.satware.ai/infrastructure/mw-pfeddersheim-workstation.git
    cd mw-pfeddersheim-workstation
    
  2. Install Ansible

    sudo pacman -S ansible
    
  3. Configure Secrets

    # 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

    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

    ./scripts/maintenance.sh