Skip to content

README.md

Latest commit

 

History

History
92 lines (70 loc) · 2.44 KB

README.md

File metadata and controls

92 lines (70 loc) · 2.44 KB

linux-setup-scripts

Ansible-based workstation setup for Debian systems.

What it sets up

Role What it does
common installs base packages (curl, wget, git, Node.js LTS, …)
shell_config fish shell, starship prompt, direnv, fzf, lsd, pyenv, Hack Nerd Font, Konsole profile
podman rootless podman, podman-compose, user socket + linger, containers.conf
vscode VS Code apt repo, installation, settings and extensions
git_config global git configuration (.gitconfig)

Requirements

  • Debian / Ubuntu based system
  • sudo access for package installation

First-time setup

# 1. Install Python and pipx dependencies
./install-requirements

# 2. Install ansible-core and Ansible collections
./install-ansible

# 3. Run the playbook
./run-ansible

Day-to-day usage

./run-ansible

To run only a specific role use tags:

cd ansible
ansible-playbook -i inventories/production/hosts.yml playbooks/workstation.yml \
  --ask-become-pass --tags shell

Available tags: common, shell, podman, vscode, git

Repository layout

ansible/
  ansible.cfg
  requirements.yml
  inventories/production/
    hosts.yml
    group_vars/all.yml
  playbooks/
    workstation.yml
  roles/
    common/
    shell_config/
    podman/
    vscode/
    git_config/
install-requirements   # installs python3, pip, venv
install-ansible        # installs ansible-core + collections
run-ansible            # runs the workstation playbook
requirements.txt       # pip packages (pipx, podman-compose)
requirements.yml       # Ansible collections

NVIDIA (manual scripts)

The nvidia/ folder contains standalone shell scripts for setting up the NVIDIA driver stack on Debian 12. These are not part of the Ansible playbook and must be run manually.

Script Purpose
install_nvidia_keyring downloads and installs the CUDA apt keyring from NVIDIA
install_nvidia_packages installs the full NVIDIA driver stack at a pinned version
list_installed_nvidia_packages lists currently installed NVIDIA packages and their versions
installed_nvidia_packages_version_580 reference list of all packages installed for driver version 580

Usage

# Step 1 — add the NVIDIA apt repository keyring
sudo ./nvidia/install_nvidia_keyring

# Step 2 — install the driver stack (edit VERSION in the script first if needed)
sudo ./nvidia/install_nvidia_packages