SERVER-CONFIGs Repository

A comprehensive collection of server configurations, Docker Compose stacks, and infrastructure management tools for deploying and maintaining multiple Linux servers and containerized applications.

Servers Managed

• KVM2: SRV-712-210 147.93.118.143 🛠️ MISC ssh.darrenneese.us
• KVM8: SRV-778-271 69.62.86.53 🏫 MOODLE!
• KVM8: SRV-761-646 167.88.42.42 📽️ BBB

🏗️ Repository Overview

This repository follows a defensive infrastructure pattern, providing production-ready configurations for web hosting, monitoring, and application deployment across multiple VPS environments.

Key Features

• Docker-first approach with Portainer management
• Multiple server environments with organized configurations
• Security-hardened setup scripts and configurations
• Comprehensive documentation and troubleshooting guides
• Environment-based configuration for easy deployment

📁 Directory Structure

├── APP-COMPOSE/          # Docker Compose applications
│   ├── BackupPC/         # Backup solution
│   ├── BookStack/        # Knowledge management
│   ├── duplicati/        # Backup client
│   ├── gitea/           # Git hosting platform
│   ├── OpenManus/       # Project management
│   └── Watchtower/      # Container auto-updater
├── SRV-*/              # Server-specific configurations
│   ├── SRV-712-210-KVM2/      # Monitoring server
│   ├── SRV-761-646-BBB/       # BigBlueButton server
│   └── SRV-778-271-MOODLE/    # Application hosting
├── LINUX-FILE-SYSTEM/  # System configuration files
├── SERVICES-TO-CONFIG/ # Service setup documentation
├── SYNOLOGY-HOME-POOL/ # Home NAS configurations
├── ai-chats/           # AI conversation documentation
├── docs/               # Documentation and guides
├── scripts/            # Automation scripts
└── templates/          # Reusable configuration templates

🚀 Quick Start

1. Server Setup

Use the provided setup scripts for new server deployment:

# For general setup (update variables first)
./staging.sh

# For Darren's specific setup
./darren.sh

2. Deploy Applications

Each application in APP-COMPOSE/ has its own setup:

cd APP-COMPOSE/[application-name]
cp .env.example .env
# Edit .env with your configuration
docker-compose up -d

3. Environment Configuration

⚠️ Security Note: All .env.example files contain placeholder values and example passwords. ALWAYS change these before deployment:

• Replace all passwords with secure, unique values
• Update domain names and URLs
• Modify user IDs and security tokens
• Review and adjust resource limits

🛠️ Infrastructure Components

Server Architecture

• Hostinger VPS environments with custom domains
• Docker containerization for all services
• Portainer for container management
• PostgreSQL as primary database
• Nginx for reverse proxy and SSL termination

Supported Applications

• Gitea: Self-hosted Git platform
• BookStack: Documentation and wiki
• BackupPC: Centralized backup solution
• Duplicati: Cross-platform backup client
• n8n: Workflow automation
• Moodle: Learning management system
• BigBlueButton: Video conferencing

📋 Prerequisites

System Requirements

• Linux server (Ubuntu 20.04+ recommended)
• Docker and Docker Compose
• Minimum 2GB RAM, 20GB storage
• Domain name with DNS access

Required Tools

• SSH access to servers
• Text editor (nano, vim, or VS Code)
• Basic shell scripting knowledge

🔒 Security Features

Built-in Security

• Environment variable isolation
• Resource limits for containers
• Health checks and monitoring
• SSL/TLS configuration
• Firewall rules and SSH hardening

Security Best Practices

1. Change default passwords in all .env files
2. Use strong, unique passwords for each service
3. Keep containers updated with Watchtower
4. Monitor logs regularly
5. Backup configurations before changes

📖 Documentation

Setup Guides

• Server Hardening
• Nginx Configuration
• Backup Strategies
• SMTP Setup

Application Guides

Each APP-COMPOSE/ directory contains:

• README.md - Setup instructions
• .env.example - Configuration template
• before-install.md - Prerequisites (if applicable)

Troubleshooting

Common issues and solutions can be found in:

• Individual application READMEs
• Troubleshooting Guide
• AI chat logs in ai-chats/

🔧 Development

VS Code Integration

This repository includes VS Code tasks for:

• Building projects (Ctrl+Shift+P → "Run Task" → "Build Project")
• Updating timestamps for AI documentation
• Running common Docker commands

Adding New Services

1. Create directory in APP-COMPOSE/
2. Use templates from templates/ directory
3. Follow naming conventions: service-name/
4. Include comprehensive documentation

🤖 AI Documentation

This repository uses an AI-assisted documentation system:

• Chat logs stored in ai-chats/ with timestamp folders
• Automatic time updates via scripts/ai-time/get_time.py
• Comprehensive conversation tracking for reference

💼 Hostinger Account Information

Account Details

• KVM2-MISC: hostinger03@superpowerlabs.co
• KVM8-BBB: (Contact for access details)
• KVM8-Moodle: darren@superpowerlabs.co

📞 Support

Getting Help

1. Check application-specific README files
2. Review troubleshooting documentation
3. Search through AI chat logs for similar issues
4. Consult service-specific documentation

Contributing

When adding configurations or documentation:

1. Follow existing directory structure
2. Include comprehensive .env.example files
3. Document prerequisites and setup steps
4. Test configurations before committing

📝 TODO

• n8n Assistant Integration

🏷️ Version Information

• Repository Structure: v2.0
• Docker Compose Format: 3.9
• Recommended OS: Ubuntu 22.04 LTS
• Last Major Update: June 2025

---

⚠️ Important: This repository contains infrastructure configurations for production servers. Always test changes in a development environment first and maintain proper backups before deploying to production.