# 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

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