homelab/ansible/roles/gitvana_bun_host/README.md

gitvana_bun_host

Ansible role to deploy Gitvana directly on a Linux VM/LXC host using Bun and systemd.

What this role does

• Installs required OS packages
• Installs Bun from official GitHub releases
• Clones/updates the Gitvana repository
• Installs dependencies with Bun
• Creates and manages a systemd unit
• Verifies service reachability over HTTP

Requirements

• Target OS: Debian 12+ or Ubuntu 22.04+
• Ansible Core 2.16+
• SSH access with privilege escalation rights

Role variables

See defaults in defaults/main.yml.

Most commonly overridden:

• gitvana_repo_url
• gitvana_repo_version
• gitvana_service_port
• gitvana_run_mode

Example playbook

---
- name: Deploy Gitvana with Bun
  hosts: docker_nodes
  become: true
  roles:
    - role: gitvana_bun_host