homelab/ansible/roles/gitvana_bun_host

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