RouterBase Ansible Collection

RouterBase provides an OpenAI-compatible API gateway at https://routerbase.com/v1.

This collection helps configure RouterBase environment files for applications, CI runners, and servers managed by Ansible.

Install

After the collection is published on Ansible Galaxy:

ansible-galaxy collection install routerbase.routerbase

From GitHub:

ansible-galaxy collection install git+https://github.com/RouterBase/ansible-routerbase.git

Example

- hosts: localhost
  gather_facts: false
  tasks:
    - name: Write RouterBase environment file
      routerbase.routerbase.routerbase_env:
        path: .env.routerbase
        api_key: "{{ lookup('env', 'ROUTERBASE_API_KEY') }}"
        model: google/gemini-2.5-flash

The generated file includes:

• ROUTERBASE_BASE_URL
• ROUTERBASE_API_KEY, when provided
• ROUTERBASE_MODEL
• OPENAI_BASE_URL
• OPENAI_API_KEY, when provided

Links

• RouterBase
• RouterBase docs
• Chat completions API

License

MIT