https://github.com/geerlingguy/ansible-role-raspberry-pi

Configures a Raspberry Pi (running Raspbian).
https://github.com/geerlingguy/ansible-role-raspberry-pi

ansible hardware pi raspberry-pi raspbian role setup

Last synced: 7 days ago
JSON representation

Configures a Raspberry Pi (running Raspbian).

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-raspberry-pi
• Owner: geerlingguy
• License: mit
• Created: 2015-12-09T04:36:15.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-25T04:01:02.000Z (9 months ago)
• Last Synced: 2024-10-10T04:06:31.187Z (25 days ago)
• Topics: ansible, hardware, pi, raspberry-pi, raspbian, role, setup
• Homepage: https://galaxy.ansible.com/geerlingguy/raspberry-pi/
• Size: 16.6 KB
• Stars: 107
• Watchers: 12
• Forks: 19
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: Raspberry Pi

[![CI](https://github.com/geerlingguy/ansible-role-raspberry-pi/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-raspberry-pi/actions?query=workflow%3ACI)

Configures a Raspberry Pi (running Raspbian).

This role will reconfigure certain options in the Raspberry Pi configuration files, but will not automatically _restart_ the Pi to make all the changes take effect. For most changes, you'll need to make sure to reboot your Pi(s) after this role runs.

## Requirements

None.

## Role Variables

Available variables are listed below, along with default values (see `defaults/main.yml`):

    raspberry_pi_boot_config_options:

      # Set the GPU memory split value.

      - regexp: "^#?gpu_mem"

        line: "gpu_mem=16"

      # Enable 1200ma USB current on newer model Pis.

      - regexp: "^#?max_usb_current"

        line: "max_usb_current=1"

Use Ansible's `lineinfile` module to ensure certain settings are configured inside `/boot/config.txt`.

    raspberry_pi_rc_local_options:

      # Disable HDMI on startup (for power savings).

      - regexp: "^/usr/bin/tvservice"

        line: "/usr/bin/tvservice -o"

Use Ansible's `lineinfile` module to ensure certain settings are configured inside `/etc/rc.local`.

## Dependencies

None.

## Example Playbook

    - hosts: pi

      vars_files:

        - vars/main.yml

      roles:

        - { role: geerlingguy.raspberry-pi }

## License

MIT / BSD

## Author Information

This role was created in 2015 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).