mirror of
https://github.com/wickedyoda/public-setupfiles.git
synced 2026-11-16 13:31:56 -06:00
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:
1 parent
b40aaf6f0e
commit
0c62f7495a
42 files changed
+4501
-865
No files matched your search
+89
-34
@@ -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`
|
||||
Reference in new issue
Block a user