docs: add READMEs and wiki documentation for all directories

- Add comprehensive wiki documentation under .github/wiki/ (19 articles)
- Add READMEs to directories that lacked them
- Fix merge conflict markers in existing READMEs
- Update root readme.md with improved structure

Co-authored-by: Jarvis <jarvis@wickedyoda.local>
This commit is contained in:
WickedYodaandJarvis authored and GitHub committed 2026-09-04 12:31:11 -05:00
1 parent b40aaf6f0e
commit 0c62f7495a
42 files changed
+4501 -865

No files matched your search

+89 -34
View File
@@ -1,40 +1,95 @@
# server_config
<<<<<<< HEAD
## Purpose
This directory contains files related to **server config**.
## Contents
- (No files detected)
## Usage
- Review each script or configuration file before running
- Some scripts may require **root or sudo**
- Paths and variables may need adjustment for your environment
## Notes
- This folder is part of the **public-setupfiles** repository
- Files are provided as-is for reference or automation
## Safety
Always back up data before running scripts that modify system state.
=======
## Overview
This directory is part of the **public-setupfiles** repository.
It contains scripts, configuration files, or resources related to **server_config**.
## Usage
- Review scripts before execution
- Some files may require **root or sudo privileges**
- Paths, variables, or credentials may need customization
## Logging & Output
Scripts may generate logs or output files in the same directory or system locations.
## Safety Notes
- Always back up important data before running scripts
- Test in a non-production environment when possible
- Use at your own risk
Server configuration templates and scripts for Debian/Ubuntu servers.
---
>>>>>>> main
## Files
| Directory | Description |
|-----------|-------------|
| `debian/` | Debian server setup scripts |
| `ubuntu/` | Ubuntu server setup scripts |
---
## Debian Setup
### `debian/debian-setup.sh`
Initial Debian server configuration:
```bash
sudo ./server_config/debian/debian-setup.sh
```
**Configures:**
- sudo access for user 'traver'
- open-vm-tools for VMware
- Git and wget
- Cockpit web UI
- Python
---
## Ubuntu Setup
### `ubuntu/ubuntu-setup.sh`
Initial Ubuntu server configuration:
```bash
sudo ./server_config/ubuntu/ubuntu-setup.sh
```
**Configures:**
- sudo access
- UFW removal (if desired)
- open-vm-tools
- Git and wget
- Cockpit web UI
- Python
---
### `ubuntu/ubuntu-docker-install.sh`
Docker installation on Ubuntu:
```bash
sudo ./server_config/ubuntu/ubuntu-docker-install.sh
```
**Installs:**
- Docker CE + CLI + containerd
- Docker Compose plugin
- Adds user to docker group
---
## First-Time Setup
```bash
# 1. Run server setup
sudo ./server_config/ubuntu/ubuntu-setup.sh
# OR
sudo ./server_config/debian/debian-setup.sh
# 2. Install Docker (optional)
sudo ./server_config/ubuntu/ubuntu-docker-install.sh
# 3. Set up updates
sudo ./setup_cron_clean.sh # Auto-updates every 6h
```
---
## Post-Installation
After running these scripts:
1. Log out and back in (for group changes)
2. Access Cockpit at `https://server-ip:9090`
3. Configure Docker if installed
4. Review auto-update settings in `/etc/cron.d/auto_updates`