From 8b6e665db3723f763a72fbd1d5ae3eb292b487ba Mon Sep 17 00:00:00 2001 From: Hyperling Date: Fri, 21 Nov 2025 17:58:52 -0700 Subject: [PATCH] Update formatting of README. Add comments on which OS's are truly currently supported. --- README.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 72 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c74cf62..ffa7aa4 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ # ansible + Getting real with system management via ansible-pull. Per-system configuration is handled via local files to the provisioned machine, @@ -10,59 +11,124 @@ accessed via the show-config and edit-config aliases. This setup is specific to the maintainer's devices and needs. You're welcome to use it as an example for your needs, but do not expect it to work as-is. -## Currently Supported Linux Systems +## Currently Supported Systems + +This information is as of 2025-11-21. + +### Primary + +These are the operating systems used as my daily driver. + +#### Debian Trixie + +This has been used as my primary server and workstation OS since at least 2024. +The `apt` version of `ansible` in both Bookworm and Trixie are sufficient, +no longer need to use `ansible` out of `pip`. + +### Secondary + +These are tested via my Docker project's `ProvisionsTests` container but not currently used as daily drivers. + +#### Arch + +TBD + +#### Fedora + +TBD + +#### OpenSUSE + +TBD + +#### Ubuntu + +TBD + +## Previusly Supported Systems + ### Debian Family + #### Debian + 100%, but only if using a recent enough version of Ansible. `pip` usually has a better version than `apt`. + #### Ubuntu + 100%, both server and desktop. + #### Pop!_OS + 100%, have not used for a while though. + #### Mint + 100%, but not really used, just tested once for fun. + #### Parrot Security OS (MATE) + 100% for a while, but OS did not serve maintainer's needs and 404 errors were terrible while updating. Ubuntu Rolling Rhino filled the gap. ### Arch Family + +#### Arch + +100% at some point, including installation and configuration of a Desktop Environment. + #### Manjaro + 100% at some point. ### Fedora Family + #### Fedora 35 -Workstation: 100% + +Workstation: 100%, Server: 100% ## Suse Family + ### openSUSE Tumbleweed v2022-02-17 -Generic: 100% + +Generic: 100%, Workstation: 100% ### openSUSE Leap 15.4 + Generic: 100% Workstation: Currently failing at `[Workstation | Linux | Flatpak Distro | Package Manager | Install From Repo]` with message `Problem: nothing provides libedataserver-1.2.so.24 needed by the to be installed evolution-data-server-32bit-3.34.4-3.3.1.x86_64`. ### NixOS + 99%, still need to get Telegraf going and refactor local.yml but everything else is working well. It is automatically implementing git.hyperling.com/me/env-nixos. -## Currently Supported Unix Systems ### FreeBSD 12, 13 + 100%, although GUI is not working completely on 13 yet (dash-to-dock doesn't compile). Software choices are slightly more limited since not `flatpak`-enabled and not feeling a `ports` setup. ## Waiting To Be Tested + ### Kali Linux + ### Arch Linux ARM + Specifically for the Pinephone. + ### Arch Linux x86 + Would be great to have Arch get built up by this. Used for many years but left after update problems due to a long computer hiatus. + ### Fedora Mobile + Specifically for the Pinephone. ## Future Goals + Eventually some of the scripts and install files will be put into the files folder. This will allow initializing systems outside of the maintainer's home network. @@ -74,6 +140,8 @@ benefit has yet to be seen for some tasks. Shared facts will definitely continue to exist under the facts tree. ## Other Notes + ### Get Setup Values + Use this command to see the variables for a system: `ansible localhost -m setup --connection=local`.