Add logo, add AppImage
Some checks failed
CI / test (push) Failing after 1m46s
Lint / test (push) Successful in 34s
Trivy / test (push) Successful in 26s

This commit is contained in:
Miguel Jacq 2025-12-15 11:48:09 +11:00
parent 3f0e38dadf
commit 839d2b9381
Signed by: mig5
GPG key ID: 59B3F0C24135C6A9
5 changed files with 384 additions and 2 deletions

View file

@ -1,5 +1,9 @@
# Enroll
<div align="center">
<img src="https://git.mig5.net/mig5/enroll/raw/branch/main/enroll.svg" alt="Enroll logo" width="240" />
</div>
**enroll** inspects a Linux machine (currently Debian-only) and generates Ansible roles for things it finds running on the machine.
It aims to be **optimistic and noninteractive**:
@ -12,7 +16,27 @@ It aims to be **optimistic and noninteractive**:
- Captures miscellaneous `/etc` files that it can't attribute to a package, and installs it in an `etc_custom` role
- Avoids trying to start systemd services that were detected as being Inactive during harvest
## Install (Poetry)
## Install
### AppImage
Download the AppImage file from the Releases page (verify with GPG if you wish, my fingerprint is [here](https://mig5.net/static/mig5.asc),
then make it executable and run it:
```bash
chmod +x Enroll.AppImage
./Enroll.AppImage
```
### Pip
```bash
pip install enroll
```
### Poetry
Clone this repository with git, then:
```bash
poetry install
@ -59,3 +83,9 @@ ansible-playbook -i "localhost," -c local /tmp/enroll-ansible/playbook.yml
## Troubleshooting
- Run as root for the most complete harvest (`sudo ...`).
## Found a bug, have a suggestion?
You can e-mail me (see the pyproject.toml for details) or contact me on the Fediverse:
https://goto.mig5.net/@mig5