mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2024-11-09 22:41:03 +01:00
Updated README.md
This commit is contained in:
parent
751c62a4b4
commit
744ce1f872
50
README.md
50
README.md
@ -8,17 +8,24 @@ With this tool you can setup all of the following application on bare metal serv
|
|||||||
## Solutions
|
## Solutions
|
||||||
|
|
||||||
### Base Setup
|
### Base Setup
|
||||||
|
|
||||||
|
Provides essential configurations for system initialization, including hostname setting, systemd journal management, locale configurations, and swapfile handling.
|
||||||
|
|
||||||
- **[Hostname](./roles/hostname/README.md)**: Sets the system's hostname.
|
- **[Hostname](./roles/hostname/README.md)**: Sets the system's hostname.
|
||||||
- **[Journalctl](./roles/journalctl/README.md)**: Configures systemd journal settings.
|
- **[Journalctl](./roles/journalctl/README.md)**: Configures systemd journal settings.
|
||||||
- **[Locales](./roles/locales/README.md)**: Configures system locales.
|
- **[Locales](./roles/locales/README.md)**: Configures system locales.
|
||||||
- **[System-Swapfile](./roles/system-swapfile/README.md)**: Configures swapfile creation and management.
|
- **[System-Swapfile](./roles/system-swapfile/README.md)**: Configures swapfile creation and management.
|
||||||
|
|
||||||
### Administration Tools
|
### Administration Tools
|
||||||
|
|
||||||
|
Includes necessary tools for effective system administration, such as Git setup, Linux admin tools, and sudo configuration.
|
||||||
|
|
||||||
- **[Git](./roles/git/)**: Basic Git version control system setup.
|
- **[Git](./roles/git/)**: Basic Git version control system setup.
|
||||||
- **[PC-Administrator-Tools](./roles/pc-administrator-tools/README.md)**: Installs basic Linux administration tools.
|
- **[PC-Administrator-Tools](./roles/pc-administrator-tools/README.md)**: Installs basic Linux administration tools.
|
||||||
- **[Sudo](./roles/sudo/README.md)**: Installs and configures sudo.
|
- **[Sudo](./roles/sudo/README.md)**: Installs and configures sudo.
|
||||||
|
|
||||||
### Backup Solutions
|
### Backup Solutions
|
||||||
|
Focuses on comprehensive backup strategies and cleanup procedures, encompassing data backups, remote server backups, and maintenance of backup storage efficiency.
|
||||||
|
|
||||||
#### Backups
|
#### Backups
|
||||||
- **[backup-data-to-usb](./roles/backup-data-to-usb/README.md)**: Automates data backup to USB devices.
|
- **[backup-data-to-usb](./roles/backup-data-to-usb/README.md)**: Automates data backup to USB devices.
|
||||||
@ -33,40 +40,56 @@ With this tool you can setup all of the following application on bare metal serv
|
|||||||
- **[cleanup-disc-space](./roles/cleanup-disc-space/README.md)**: Manages and frees up disk space on the system.
|
- **[cleanup-disc-space](./roles/cleanup-disc-space/README.md)**: Manages and frees up disk space on the system.
|
||||||
- **[cleanup-failed-docker-backups](./roles/cleanup-failed-docker-backups/README.md)**: Cleans up failed Docker backups.
|
- **[cleanup-failed-docker-backups](./roles/cleanup-failed-docker-backups/README.md)**: Cleans up failed Docker backups.
|
||||||
|
|
||||||
### Notifier
|
### Monitoring
|
||||||
|
|
||||||
|
#### Notifier
|
||||||
|
Introduces roles for setting up system event notifications, with options for email and Telegram alerts.
|
||||||
- **[Systemd-Notifier](./roles/systemd-notifier/README.md)**: Notifier service for systemd.
|
- **[Systemd-Notifier](./roles/systemd-notifier/README.md)**: Notifier service for systemd.
|
||||||
- **[Systemd-Notifier-Email](./roles/systemd-notifier-email/README.md)**: Email notifications for systemd services.
|
- **[Systemd-Notifier-Email](./roles/systemd-notifier-email/README.md)**: Email notifications for systemd services.
|
||||||
- **[Systemd-Notifier-Telegram](./roles/systemd-notifier-telegram/README.md)**: Telegram notifications for systemd services.
|
- **[Systemd-Notifier-Telegram](./roles/systemd-notifier-telegram/README.md)**: Telegram notifications for systemd services.
|
||||||
|
|
||||||
|
#### Server Health
|
||||||
|
Addresses server maintenance and health monitoring, ensuring optimal performance and reliability of the server infrastructure.
|
||||||
|
- **[Health Btrfs](./roles/health-btrfs/)**: Monitors the health of Btrfs filesystems.
|
||||||
|
- **[Health Disc Space](./roles/health-disc-space/)**: Checks for available disk space.
|
||||||
|
- **[Health Docker Container](./roles/health-docker-container/)**: Monitors the health of Docker containers.
|
||||||
|
- **[Health Docker Volumes](./roles/health-docker-volumes/)**: Checks the status of Docker volumes.
|
||||||
|
- **[Health Journalctl](./roles/health-journalctl/)**: Monitors and manages the system journal.
|
||||||
|
- **[Health Nginx](./roles/health-nginx/)**: Ensures the Nginx server is running smoothly.
|
||||||
|
- **[Heal Docker](./roles/heal-docker/)**: Automated healing and maintenance tasks for Docker.
|
||||||
|
|
||||||
### Update
|
### Update
|
||||||
|
Covers automated updates and maintenance for the system and its components, including package managers and Docker containers.
|
||||||
- **[update](./roles/update/README.md)**: Automates the process of system updates.
|
- **[update](./roles/update/README.md)**: Automates the process of system updates.
|
||||||
- **[update-apt](./roles/update-apt/README.md)**: Updates system packages using apt (for Debian-based systems).
|
- **[update-apt](./roles/update-apt/README.md)**: Updates system packages using apt (for Debian-based systems).
|
||||||
- **[update-docker](./roles/update-docker/README.md)**: Keeps Docker containers up to date.
|
- **[update-docker](./roles/update-docker/README.md)**: Keeps Docker containers up to date.
|
||||||
- **[update-pacman](./roles/update-pacman/README.md)**: Updates system packages using Pacman (for Arch-based systems).
|
- **[update-pacman](./roles/update-pacman/README.md)**: Updates system packages using Pacman (for Arch-based systems).
|
||||||
|
|
||||||
### Driver
|
### Driver
|
||||||
|
Deals with the installation and configuration of various hardware drivers, catering to a range of devices and needs.
|
||||||
- **[driver-epson-multiprinter](./roles/driver-epson-multiprinter/README.md)**: Installs drivers for Epson multi-function printers.
|
- **[driver-epson-multiprinter](./roles/driver-epson-multiprinter/README.md)**: Installs drivers for Epson multi-function printers.
|
||||||
- **[driver-intel](./roles/driver-intel/README.md)**: Installs Intel drivers, typically for graphics and other hardware.
|
- **[driver-intel](./roles/driver-intel/README.md)**: Installs Intel drivers, typically for graphics and other hardware.
|
||||||
- **[driver-msi-keyboard-color](./roles/driver-msi-keyboard-color/README.md)**: Configures MSI keyboard color settings.
|
- **[driver-msi-keyboard-color](./roles/driver-msi-keyboard-color/README.md)**: Configures MSI keyboard color settings.
|
||||||
- **[driver-non-free](./roles/driver-non-free/README.md)**: Installs non-free drivers, generally for specific hardware needs.
|
- **[driver-non-free](./roles/driver-non-free/README.md)**: Installs non-free drivers, generally for specific hardware needs.
|
||||||
|
|
||||||
### Security
|
### Security
|
||||||
|
Enhances system security through roles focused on security measures, swap file management, user configurations, and SSH settings.
|
||||||
- **[System Security](./roles/system-security/)**: Enhances overall system security.
|
- **[System Security](./roles/system-security/)**: Enhances overall system security.
|
||||||
- **[System Swapfile](./roles/system-swapfile/)**: Manages swap files for system memory.
|
- **[System Swapfile](./roles/system-swapfile/)**: Manages swap files for system memory.
|
||||||
- **[User Administrator](./roles/user-administrator/)**: Setup for system administrator user.
|
- **[User Administrator](./roles/user-administrator/)**: Setup for system administrator user.
|
||||||
- **[User Alarm](./roles/user-alarm/)**: Manages the alarm user.
|
- **[User Alarm](./roles/user-alarm/)**: Manages the alarm user.
|
||||||
- **[PC SSH](./roles/pc-ssh/)**: Configuration of SSH for secure remote access.
|
- **[PC SSH](./roles/pc-ssh/)**: Configuration of SSH for secure remote access.
|
||||||
- **[Sshd](./roles/sshd/README.md)**: Configures SSH daemon settings.
|
- **[SSHD](./roles/sshd/README.md)**: Configures SSH daemon settings.
|
||||||
|
|
||||||
### Virtual Private Network
|
### Virtual Private Network (VPN)
|
||||||
|
Centers on VPN configurations, specifically for Wireguard, providing secure and efficient network connectivity.
|
||||||
- **[client-wireguard](./roles/client-wireguard/README.md)**: Configures Wireguard VPN client.
|
- **[client-wireguard](./roles/client-wireguard/README.md)**: Configures Wireguard VPN client.
|
||||||
- **[client-wireguard-behind-firewall](./roles/client-wireguard-behind-firewall/README.md)**: Sets up Wireguard client functionality behind a firewall.
|
- **[client-wireguard-behind-firewall](./roles/client-wireguard-behind-firewall/README.md)**: Sets up Wireguard client functionality behind a firewall.
|
||||||
- **[wireguard](./roles/wireguard/README.md)**: Installs and configures Wireguard for secure VPN connections.
|
- **[wireguard](./roles/wireguard/README.md)**: Installs and configures Wireguard for secure VPN connections.
|
||||||
|
|
||||||
|
|
||||||
### Desktop and Personal Computing
|
### Desktop and Personal Computing
|
||||||
Tools and software enhancing personal computing on desktops or laptops:
|
Offers a range of tools and software to enhance the personal computing experience on desktops and laptops, covering multimedia, productivity, and virtualization.
|
||||||
|
|
||||||
- **[PC Bluray Player Tools](./roles/pc-bluray-player-tools/)**: Software for playing Blu-ray media on personal computers.
|
- **[PC Bluray Player Tools](./roles/pc-bluray-player-tools/)**: Software for playing Blu-ray media on personal computers.
|
||||||
- **[PC Caffeine](./roles/pc-caffeine/)**: Utility to keep your computer awake.
|
- **[PC Caffeine](./roles/pc-caffeine/)**: Utility to keep your computer awake.
|
||||||
- **[PC Designer Tools](./roles/pc-designer-tools/)**: Graphic design and 3D modeling software.
|
- **[PC Designer Tools](./roles/pc-designer-tools/)**: Graphic design and 3D modeling software.
|
||||||
@ -84,7 +107,7 @@ Tools and software enhancing personal computing on desktops or laptops:
|
|||||||
- **[PC Virtual Box](./roles/pc-virtual-box/)**: VirtualBox setup for creating virtual machines.
|
- **[PC Virtual Box](./roles/pc-virtual-box/)**: VirtualBox setup for creating virtual machines.
|
||||||
|
|
||||||
### Development Environment
|
### Development Environment
|
||||||
Tools and environments for software development.
|
Targets software developers with tools and environments for various programming languages and development needs.
|
||||||
- **[PC Developer Tools](./roles/pc-developer-tools/)**: Basic developer tools setup.
|
- **[PC Developer Tools](./roles/pc-developer-tools/)**: Basic developer tools setup.
|
||||||
- **[PC Developer Tools Arduino](./roles/pc-developer-tools-arduino/)**: Setup for Arduino development.
|
- **[PC Developer Tools Arduino](./roles/pc-developer-tools-arduino/)**: Setup for Arduino development.
|
||||||
- **[PC Developer Tools Bash](./roles/pc-developer-tools-bash/)**: Tools for Bash scripting.
|
- **[PC Developer Tools Bash](./roles/pc-developer-tools-bash/)**: Tools for Bash scripting.
|
||||||
@ -93,6 +116,7 @@ Tools and environments for software development.
|
|||||||
- **[PC Developer Tools Python](./roles/pc-developer-tools-python/)**: Python development environment setup.
|
- **[PC Developer Tools Python](./roles/pc-developer-tools-python/)**: Python development environment setup.
|
||||||
|
|
||||||
### Other
|
### Other
|
||||||
|
Encompasses miscellaneous essential tools and systems, including AUR helper, spellchecking, typesetting, and package management.
|
||||||
- **[System-Aur-Helper](./roles/system-aur-helper/README.md)**: Installs and configures AUR helper (yay).
|
- **[System-Aur-Helper](./roles/system-aur-helper/README.md)**: Installs and configures AUR helper (yay).
|
||||||
- **[Hunspell](./roles/hunspell/)**: Installation of Hunspell spellchecker.
|
- **[Hunspell](./roles/hunspell/)**: Installation of Hunspell spellchecker.
|
||||||
- **[Latex](./roles/latex/)**: Installation of LaTeX typesetting system.
|
- **[Latex](./roles/latex/)**: Installation of LaTeX typesetting system.
|
||||||
@ -102,7 +126,7 @@ Tools and environments for software development.
|
|||||||
## Server
|
## Server
|
||||||
|
|
||||||
### Webserver
|
### Webserver
|
||||||
Roles for web servers and related applications.
|
Focuses on web server roles and applications, covering SSL certificates, Nginx configurations, reverse proxies, and email services.
|
||||||
- **[Letsencrypt](./roles/letsencrypt/README.md)**: Configures Let's Encrypt for SSL certificates.
|
- **[Letsencrypt](./roles/letsencrypt/README.md)**: Configures Let's Encrypt for SSL certificates.
|
||||||
- **[Nginx](./roles/nginx/README.md)**: Installs and configures Nginx web server.
|
- **[Nginx](./roles/nginx/README.md)**: Installs and configures Nginx web server.
|
||||||
- **[Nginx-Docker-Reverse-Proxy](./roles/nginx-docker-reverse-proxy/README.md)**: Sets up a reverse proxy for Docker containers.
|
- **[Nginx-Docker-Reverse-Proxy](./roles/nginx-docker-reverse-proxy/README.md)**: Sets up a reverse proxy for Docker containers.
|
||||||
@ -114,8 +138,7 @@ Roles for web servers and related applications.
|
|||||||
- **[Postfix](./roles/postfix/)**: Setup for the Postfix mail transfer agent.
|
- **[Postfix](./roles/postfix/)**: Setup for the Postfix mail transfer agent.
|
||||||
|
|
||||||
### Docker and Containerization
|
### Docker and Containerization
|
||||||
Setting up Docker containers and managing applications.
|
Dedicated to Docker container setups and application management, offering a wide array of software deployment options.
|
||||||
|
|
||||||
- **[Docker](./roles/docker/)**: Basic Docker and Docker Compose setup.
|
- **[Docker](./roles/docker/)**: Basic Docker and Docker Compose setup.
|
||||||
- **[Docker Akaunting](./roles/docker-akaunting/)**: Deployment of the Akaunting finance software.
|
- **[Docker Akaunting](./roles/docker-akaunting/)**: Deployment of the Akaunting finance software.
|
||||||
- **[Docker Attendize](./roles/docker-attendize/)**: Setup for the Attendize event management tool.
|
- **[Docker Attendize](./roles/docker-attendize/)**: Setup for the Attendize event management tool.
|
||||||
@ -139,15 +162,6 @@ Setting up Docker containers and managing applications.
|
|||||||
- **[Docker Wordpress](./roles/docker-wordpress/)**: Wordpress blog and website platform setup.
|
- **[Docker Wordpress](./roles/docker-wordpress/)**: Wordpress blog and website platform setup.
|
||||||
- **[Docker YOURLS](./roles/docker-yourls/)**: Setup for YOURLS, a URL shortening service.
|
- **[Docker YOURLS](./roles/docker-yourls/)**: Setup for YOURLS, a URL shortening service.
|
||||||
|
|
||||||
## Server Health
|
|
||||||
- **[Health Btrfs](./roles/health-btrfs/)**: Monitors the health of Btrfs filesystems.
|
|
||||||
- **[Health Disc Space](./roles/health-disc-space/)**: Checks for available disk space.
|
|
||||||
- **[Health Docker Container](./roles/health-docker-container/)**: Monitors the health of Docker containers.
|
|
||||||
- **[Health Docker Volumes](./roles/health-docker-volumes/)**: Checks the status of Docker volumes.
|
|
||||||
- **[Health Journalctl](./roles/health-journalctl/)**: Monitors and manages the system journal.
|
|
||||||
- **[Health Nginx](./roles/health-nginx/)**: Ensures the Nginx server is running smoothly.
|
|
||||||
- **[Heal Docker](./roles/heal-docker/)**: Automated healing and maintenance tasks for Docker.
|
|
||||||
|
|
||||||
### Setup
|
### Setup
|
||||||
|
|
||||||
Run:
|
Run:
|
||||||
|
Loading…
Reference in New Issue
Block a user