---
description: >-
  Workstation bootstrapping and setup instructions using Ansible.
tags:
  - setup
  - bootstrap
  - ansible
last_updated: '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**
   ```bash
   mkdir -p ~/infrastructure
   cd ~/infrastructure
   git clone https://git.satware.ai/infrastructure/mw-pfeddersheim-workstation.git
   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
   ```