{"id":15151561,"url":"https://github.com/wbreiler/piansible","last_synced_at":"2026-02-27T01:02:37.578Z","repository":{"id":254914171,"uuid":"847945595","full_name":"wbreiler/PiAnsible","owner":"wbreiler","description":"Ansible playbooks for automating Raspberry Pi OS Lite setup, including Docker, Docker Compose, and Apache2 in Docker.","archived":false,"fork":false,"pushed_at":"2025-01-12T07:39:56.000Z","size":48,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T00:32:24.632Z","etag":null,"topics":["ansible","ansible-playbook","apache","apache2","automation","devops","docker","docker-compose","iac","infrastructure-as-code","raspberry-pi-os","sysadmin","system-administration"],"latest_commit_sha":null,"homepage":"https://piansible.wbreiler.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wbreiler.png","metadata":{"files":{"readme":null,"changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-26T21:03:26.000Z","updated_at":"2025-01-12T07:39:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"711a86d3-9f4f-4297-9941-da519b857eca","html_url":"https://github.com/wbreiler/PiAnsible","commit_stats":{"total_commits":44,"total_committers":2,"mean_commits":22.0,"dds":0.09090909090909094,"last_synced_commit":"aba2447c338ff6ebb4829d7ee341458924c8b151"},"previous_names":["wbreiler/piansible"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbreiler%2FPiAnsible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbreiler%2FPiAnsible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbreiler%2FPiAnsible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wbreiler%2FPiAnsible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wbreiler","download_url":"https://codeload.github.com/wbreiler/PiAnsible/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237932070,"owners_count":19389560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-playbook","apache","apache2","automation","devops","docker","docker-compose","iac","infrastructure-as-code","raspberry-pi-os","sysadmin","system-administration"],"created_at":"2024-09-26T15:04:23.003Z","updated_at":"2025-10-24T07:31:05.144Z","avatar_url":"https://github.com/wbreiler.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# PiAnsible\n\nPiAnsible is an Ansible project designed to automate the setup of services on Raspberry Pi OS Lite. This repository includes playbooks to install and configure Docker, Docker Compose, disable IPv6, install Netdata, and install Apache2 in Docker.\n\n## Getting Started\n\n### Prerequisites\n\n- Ansible installed on your local machine.\n- Access to a computer or computers running Debian.\n- SSH access to the computer(s).\n\nNote: This playbook has only been tested on a Raspberry Pi 4 B running Raspberry Pi OS Lite 64-bit. It should work on other distros and architectures, however if there are any issues create an issue and I will look into it when I have the time.\n\n### Directory Structure\n\nYour project should include the following directory structure:\n\n```\nPiAnsible/\n├── tasks/\n│   ├── update-upgrade.yml\n│   ├── docker-compose.yml\n│   ├── apache-docker.yml\n│   ├── disable-ipv6.yml\n│   ├── install_netdata.yml\n├── vars/\n│   ├── netdata_credentials.yml\n├── inventory.example.ini\n├── main.yml\n└── index.html  # Create this file as described below\n```\n\n### Creating the `index.html` File\n\n1. Navigate to the root directory of your `PiAnsible` repository.\n2. Create an `index.html` file with the following command:\n\n```bash\n   touch index.html\n```\n\n3. Edit the `index.html` file to include your desired content. Here's a simple example:\n\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"en\"\u003e\n\u003chead\u003e\n  \u003cmeta charset=\"UTF-8\"\u003e\n  \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"\u003e\n  \u003ctitle\u003eWelcome to PiAnsible!\u003c/title\u003e\n  \u003cstyle\u003e\n    body {\n      font-family: Arial, sans-serif;\n      background-color: #f4f4f9;\n      color: #333;\n      margin: 0;\n      padding: 0;\n      text-align: center;\n    }\n    .container {\n      max-width: 800px;\n      margin: 50px auto;\n      padding: 20px;\n      background: #fff;\n      border-radius: 8px;\n      box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);\n    }\n    h1 {\n      color: #0056b3;\n    }\n    p {\n      font-size: 1.2em;\n      line-height: 1.6;\n    }\n    .footer {\n      margin-top: 30px;\n      font-size: 0.9em;\n      color: #777;\n    }\n    a.button {\n      display: inline-block;\n      padding: 10px 20px;\n      font-size: 1em;\n      color: #fff;\n      background-color: #0056b3;\n      border: none;\n      border-radius: 5px;\n      text-decoration: none;\n      transition: background-color 0.3s ease;\n    }\n    a.button:hover {\n      background-color: #003d7a;\n    }\n  \u003c/style\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n  \u003cdiv class=\"container\"\u003e\n    \u003ch1\u003eWelcome to PiAnsible!\u003c/h1\u003e\n    \u003cp\u003eThis is the default page served by your Apache2 Docker container. PiAnsible is an Ansible project designed to automate the setup of services on Raspberry Pi OS Lite.\u003c/p\u003e\n    \u003cp\u003eFor more information and to get started, visit the project repository on GitHub.\u003c/p\u003e\n    \u003ca href=\"https://github.com/wbreiler/PiAnsible\" class=\"button\"\u003eVisit GitHub Repository\u003c/a\u003e\n    \u003cdiv class=\"footer\"\u003e\n      \u003cp\u003e\u0026copy; 2024 PiAnsible. All rights reserved.\u003c/p\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/body\u003e\n\u003c/html\u003e\n```\n\n### Using this playbook\n\n1. Store your Netdata credentials in the `vars/netdata_credentials.yml` file\n    - `touch vars/netdata_credentials.yml`\n    - Open the file in your favorite text editor\n    - Your credentials file should look like this:\n\n      ```yml\n      ---\n      claim_token: \"your-claim-token-here\"\n      claim_rooms: \"your-claim-rooms-here\"\n      ```\n\n2. **Set up the Inventory File**: Copy `inventory.example.ini` to `inventory.ini`, and edit it to match your setup\n    - Example:\n\n    ```ini\n    [all]\n    pi.local ansible_user=pi\n    ```\n\n3. **Run the Playbook**\n  \n  ```bash\n  ansible-playbook main.yml\n  ```\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 (GPL-3.0).\n\n### What This Means\n\nThe GPL-3.0 is a free software license that guarantees end users the freedom to run, study, share, and modify the software. The key aspects of GPL-3.0 include:\n\n- Freedom to Use: You can use the software for any purpose.\n- Freedom to Study and Modify: You can study how the program works and change it to make it do what you wish. Access to the source code is a precondition for this.\n- Freedom to Distribute Copies: You can redistribute copies of the original program so you can help others.\n- Freedom to Distribute Modified Versions: You can distribute copies of your modified versions to others. By doing this you can give the whole community a chance to benefit from your changes. Access to the source code is a precondition for this.\n\nIf you distribute copies or modified versions of the software, you must pass on the same freedoms to others. That means you must distribute the source code and keep the GPL license intact.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwbreiler%2Fpiansible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwbreiler%2Fpiansible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwbreiler%2Fpiansible/lists"}