Sanitized mirror from private repository - 2026-04-18 11:19:59 UTC
This commit is contained in:
67
archive/dokuwiki/README.md
Normal file
67
archive/dokuwiki/README.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# DokuWiki Documentation Format
|
||||
|
||||
This directory contains the homelab documentation formatted for DokuWiki. DokuWiki uses a different syntax than standard Markdown.
|
||||
|
||||
## 📁 File Structure
|
||||
|
||||
- `start.txt` - Main documentation index page
|
||||
- `services-popular.txt` - Popular services guide
|
||||
- `services-individual-index.txt` - **NEW!** Complete index of all 159 individual service docs
|
||||
- `getting-started-quick-start.txt` - Quick start guide
|
||||
|
||||
## 🔧 How to Use
|
||||
|
||||
### Option 1: Copy Individual Files
|
||||
1. Copy the `.txt` files to your DokuWiki `data/pages/` directory
|
||||
2. Create appropriate subdirectories (e.g., `services/`, `getting-started/`)
|
||||
3. Access via your DokuWiki web interface
|
||||
|
||||
### Option 2: Bulk Import
|
||||
1. Create the following directory structure in your DokuWiki:
|
||||
```
|
||||
data/pages/homelab/
|
||||
├── start.txt
|
||||
├── services/
|
||||
│ └── popular.txt
|
||||
├── getting-started/
|
||||
├── infrastructure/
|
||||
├── admin/
|
||||
├── troubleshooting/
|
||||
└── advanced/
|
||||
```
|
||||
|
||||
2. Copy files to appropriate directories
|
||||
3. Access at `http://your-dokuwiki/doku.php?id=homelab:start`
|
||||
|
||||
## 🎨 DokuWiki Syntax Used
|
||||
|
||||
- `======` for main headings
|
||||
- `=====` for subheadings
|
||||
- `====` for sub-subheadings
|
||||
- `^` for table headers
|
||||
- `|` for table cells
|
||||
- `[[namespace:page|Link Text]]` for internal links
|
||||
- `<code>` blocks for code examples
|
||||
- `//italic//` and `**bold**` for emphasis
|
||||
|
||||
## 🔄 Converting from Markdown
|
||||
|
||||
Key differences from Markdown:
|
||||
- Headers use `=` instead of `#`
|
||||
- Tables use `^` for headers and `|` for cells
|
||||
- Links use `[[]]` syntax
|
||||
- Code blocks use `<code>` tags
|
||||
- Lists use ` *` (two spaces + asterisk)
|
||||
|
||||
## 📝 Customization
|
||||
|
||||
You can customize these files for your DokuWiki installation:
|
||||
- Update internal links to match your namespace structure
|
||||
- Modify styling and formatting as needed
|
||||
- Add your own branding or additional content
|
||||
|
||||
## 🔗 Related
|
||||
|
||||
- Main documentation: `../docs/`
|
||||
- Joplin format: `../joplin/`
|
||||
- Original repository structure: `../`
|
||||
322
archive/dokuwiki/getting-started-quick-start.txt
Normal file
322
archive/dokuwiki/getting-started-quick-start.txt
Normal file
@@ -0,0 +1,322 @@
|
||||
====== Quick Start Guide ======
|
||||
|
||||
**🟢 Beginner-Friendly**
|
||||
|
||||
Get up and running with your first homelab service in under 30 minutes! This guide will walk you through deploying a simple service using the established patterns from this homelab.
|
||||
|
||||
===== What We'll Build =====
|
||||
|
||||
We'll deploy **Uptime Kuma** - a simple, beginner-friendly monitoring tool that will:
|
||||
* Monitor your other services
|
||||
* Send you alerts when things go down
|
||||
* Provide a beautiful dashboard
|
||||
* Teach you the basic deployment patterns
|
||||
|
||||
===== Prerequisites =====
|
||||
|
||||
==== What You Need ====
|
||||
* A computer running Linux (Ubuntu, Debian, or similar)
|
||||
* Docker and Docker Compose installed
|
||||
* Basic command line knowledge
|
||||
* 30 minutes of time
|
||||
|
||||
==== Install Docker (if needed) ====
|
||||
<code bash>
|
||||
# Update system
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# Install Docker
|
||||
curl -fsSL https://get.docker.com -o get-docker.sh
|
||||
sudo sh get-docker.sh
|
||||
|
||||
# Add your user to docker group
|
||||
sudo usermod -aG docker $USER
|
||||
|
||||
# Install Docker Compose
|
||||
sudo apt install docker-compose -y
|
||||
|
||||
# Verify installation
|
||||
docker --version
|
||||
docker-compose --version
|
||||
</code>
|
||||
|
||||
===== Step 1: Create Project Structure =====
|
||||
|
||||
<code bash>
|
||||
# Create project directory
|
||||
mkdir -p ~/homelab/monitoring
|
||||
cd ~/homelab/monitoring
|
||||
|
||||
# Create the directory structure
|
||||
mkdir -p uptime-kuma/data
|
||||
</code>
|
||||
|
||||
===== Step 2: Create Docker Compose File =====
|
||||
|
||||
Create the main configuration file:
|
||||
|
||||
<code bash>
|
||||
cat > uptime-kuma/docker-compose.yml << 'EOF'
|
||||
version: '3.9'
|
||||
|
||||
services:
|
||||
uptime-kuma:
|
||||
image: louislam/uptime-kuma:latest
|
||||
container_name: Uptime-Kuma
|
||||
hostname: uptime-kuma
|
||||
|
||||
# Security settings
|
||||
security_opt:
|
||||
- no-new-privileges:true
|
||||
user: 1000:1000 # Adjust for your system
|
||||
|
||||
# Health check
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost:3001/api/status-page/heartbeat/default"]
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
start_period: 60s
|
||||
|
||||
# Restart policy
|
||||
restart: on-failure:5
|
||||
|
||||
# Resource limits
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
memory: 512M
|
||||
cpus: '0.5'
|
||||
|
||||
# Port mapping
|
||||
ports:
|
||||
- "3001:3001"
|
||||
|
||||
# Data persistence
|
||||
volumes:
|
||||
- ./data:/app/data:rw
|
||||
- /etc/localtime:/etc/localtime:ro
|
||||
|
||||
# Environment variables
|
||||
environment:
|
||||
- TZ=America/Los_Angeles # Change to your timezone
|
||||
|
||||
# Custom network
|
||||
networks:
|
||||
- monitoring-network
|
||||
|
||||
networks:
|
||||
monitoring-network:
|
||||
name: monitoring-network
|
||||
ipam:
|
||||
config:
|
||||
- subnet: 192.168.100.0/24
|
||||
EOF
|
||||
</code>
|
||||
|
||||
===== Step 3: Configure Environment =====
|
||||
|
||||
Create an environment file for easy customization:
|
||||
|
||||
<code bash>
|
||||
cat > uptime-kuma/.env << 'EOF'
|
||||
# Timezone (change to your location)
|
||||
TZ=America/Los_Angeles
|
||||
|
||||
# User ID and Group ID (run 'id' command to find yours)
|
||||
PUID=1000
|
||||
PGID=1000
|
||||
|
||||
# Port (change if 3001 is already in use)
|
||||
PORT=3001
|
||||
EOF
|
||||
</code>
|
||||
|
||||
===== Step 4: Deploy the Service =====
|
||||
|
||||
<code bash>
|
||||
# Navigate to the service directory
|
||||
cd uptime-kuma
|
||||
|
||||
# Start the service
|
||||
docker-compose up -d
|
||||
|
||||
# Check if it's running
|
||||
docker-compose ps
|
||||
|
||||
# View logs
|
||||
docker-compose logs -f
|
||||
</code>
|
||||
|
||||
You should see output like:
|
||||
<code>
|
||||
uptime-kuma_1 | Welcome to Uptime Kuma
|
||||
uptime-kuma_1 | Server is running on port 3001
|
||||
</code>
|
||||
|
||||
===== Step 5: Access Your Service =====
|
||||
|
||||
- **Open your web browser**
|
||||
- **Navigate to**: ''http://your-server-ip:3001''
|
||||
- **Create admin account** on first visit
|
||||
- **Start monitoring services!**
|
||||
|
||||
===== Step 6: Add Your First Monitor =====
|
||||
|
||||
- **Click "Add New Monitor"**
|
||||
- **Configure a basic HTTP monitor**:
|
||||
* **Monitor Type**: HTTP(s)
|
||||
* **Friendly Name**: Google
|
||||
* **URL**: https://google.com
|
||||
* **Heartbeat Interval**: 60 seconds
|
||||
- **Click "Save"**
|
||||
|
||||
Congratulations! You've deployed your first homelab service! 🎉
|
||||
|
||||
===== Understanding What We Built =====
|
||||
|
||||
==== Docker Compose Structure ====
|
||||
<code yaml>
|
||||
# This tells Docker what version of compose syntax we're using
|
||||
version: '3.9'
|
||||
|
||||
# Services section defines our containers
|
||||
services:
|
||||
uptime-kuma: # Service name
|
||||
image: louislam/uptime-kuma # Docker image to use
|
||||
container_name: Uptime-Kuma # Custom container name
|
||||
ports: # Port mapping (host:container)
|
||||
- "3001:3001"
|
||||
volumes: # Data persistence
|
||||
- ./data:/app/data:rw # Maps local ./data to container /app/data
|
||||
environment: # Environment variables
|
||||
- TZ=America/Los_Angeles
|
||||
</code>
|
||||
|
||||
==== Security Features ====
|
||||
* **no-new-privileges**: Prevents privilege escalation
|
||||
* **User mapping**: Runs as non-root user
|
||||
* **Resource limits**: Prevents resource exhaustion
|
||||
* **Health checks**: Monitors service health
|
||||
|
||||
==== Monitoring Features ====
|
||||
* **Health checks**: Docker monitors the container
|
||||
* **Restart policy**: Automatically restarts on failure
|
||||
* **Logging**: All output captured by Docker
|
||||
|
||||
===== Next Steps - Expand Your Homelab =====
|
||||
|
||||
==== 🟢 Beginner Services (Try Next) ====
|
||||
- **Pi-hole** - Block ads network-wide
|
||||
<code bash>
|
||||
# Copy the uptime-kuma pattern and adapt for Pi-hole
|
||||
mkdir ~/homelab/pihole
|
||||
# Use the Pi-hole configuration from Atlantis/pihole.yml
|
||||
</code>
|
||||
|
||||
- **Portainer** - Manage Docker containers with a web UI
|
||||
<code bash>
|
||||
mkdir ~/homelab/portainer
|
||||
# Adapt the pattern for Portainer
|
||||
</code>
|
||||
|
||||
- **Nginx Proxy Manager** - Manage reverse proxy with SSL
|
||||
<code bash>
|
||||
mkdir ~/homelab/proxy
|
||||
# Use the pattern from Atlantis/nginxproxymanager/
|
||||
</code>
|
||||
|
||||
==== 🟡 Intermediate Services (When Ready) ====
|
||||
- **Plex or Jellyfin** - Media streaming
|
||||
- **Vaultwarden** - Password manager
|
||||
- **Grafana + Prometheus** - Advanced monitoring
|
||||
|
||||
==== 🔴 Advanced Services (For Later) ====
|
||||
- **GitLab** - Complete DevOps platform
|
||||
- **Home Assistant** - Smart home automation
|
||||
- **Matrix Synapse** - Decentralized chat
|
||||
|
||||
===== Common Customizations =====
|
||||
|
||||
==== Change the Port ====
|
||||
If port 3001 is already in use:
|
||||
<code yaml>
|
||||
ports:
|
||||
- "3002:3001" # Use port 3002 instead
|
||||
</code>
|
||||
|
||||
==== Different Data Location ====
|
||||
To store data elsewhere:
|
||||
<code yaml>
|
||||
volumes:
|
||||
- /home/user/uptime-data:/app/data:rw
|
||||
</code>
|
||||
|
||||
==== Add Resource Limits ====
|
||||
For a more powerful server:
|
||||
<code yaml>
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
memory: 1G
|
||||
cpus: '1.0'
|
||||
</code>
|
||||
|
||||
===== Troubleshooting =====
|
||||
|
||||
==== Service Won't Start ====
|
||||
<code bash>
|
||||
# Check logs for errors
|
||||
docker-compose logs
|
||||
|
||||
# Check if port is already in use
|
||||
sudo netstat -tulpn | grep :3001
|
||||
|
||||
# Check file permissions
|
||||
ls -la data/
|
||||
</code>
|
||||
|
||||
==== Can't Access Web Interface ====
|
||||
<code bash>
|
||||
# Check if container is running
|
||||
docker ps
|
||||
|
||||
# Test internal connectivity
|
||||
docker exec Uptime-Kuma curl http://localhost:3001
|
||||
|
||||
# Check firewall
|
||||
sudo ufw status
|
||||
sudo ufw allow 3001
|
||||
</code>
|
||||
|
||||
==== Data Not Persisting ====
|
||||
<code bash>
|
||||
# Check volume mount
|
||||
docker inspect Uptime-Kuma | grep -A 10 Mounts
|
||||
|
||||
# Fix permissions
|
||||
sudo chown -R 1000:1000 ./data
|
||||
</code>
|
||||
|
||||
===== What You've Learned =====
|
||||
|
||||
✅ **Docker Compose basics**\\
|
||||
✅ **Service deployment patterns**\\
|
||||
✅ **Data persistence with volumes**\\
|
||||
✅ **Network configuration**\\
|
||||
✅ **Security best practices**\\
|
||||
✅ **Health monitoring**\\
|
||||
✅ **Troubleshooting basics**\\
|
||||
|
||||
===== Next Reading =====
|
||||
|
||||
* [[getting-started:architecture|Architecture Overview]]: Understand how everything fits together
|
||||
* [[services:categories|Service Categories]]: Explore what services are available
|
||||
* [[admin:deployment|Deployment Guide]]: Learn advanced deployment patterns
|
||||
* [[troubleshooting:common-issues|Common Issues]]: Troubleshoot problems
|
||||
|
||||
----
|
||||
|
||||
**🎉 Congratulations!** You've successfully deployed your first homelab service using the same patterns used across all 176 services in this infrastructure. You're now ready to explore more complex services and build your own homelab empire!
|
||||
|
||||
//Remember: Every expert was once a beginner. Start small, learn continuously, and don't be afraid to break things - that's how you learn!//
|
||||
510
archive/dokuwiki/port-forwarding-configuration.txt
Normal file
510
archive/dokuwiki/port-forwarding-configuration.txt
Normal file
@@ -0,0 +1,510 @@
|
||||
====== 🔌 Port Forwarding Configuration ======
|
||||
|
||||
**🟡 Intermediate Infrastructure Guide**
|
||||
|
||||
This document details the current port forwarding configuration on the TP-Link Archer BE800 router, enabling external access to specific homelab services with automatic DDNS updates every 5 minutes.
|
||||
|
||||
<WRAP center round info 60%>
|
||||
**🌐 Automatic Domain Updates**\\
|
||||
All domains are automatically updated via Cloudflare DDNS every 5 minutes, eliminating the need for manual IP management.
|
||||
</WRAP>
|
||||
|
||||
===== 🔧 Current Port Forwarding Rules =====
|
||||
|
||||
Based on the TP-Link Archer BE800 router configuration:
|
||||
|
||||
==== 📊 Active Port Forwards Summary ====
|
||||
^ Service Name ^ Device IP ^ External Port ^ Internal Port ^ Protocol ^ Domain Access ^
|
||||
| **jitsi3** | 192.168.0.200 | 4443 | 4443 | TCP | meet.thevish.io:4443 |
|
||||
| **stun3** | 192.168.0.200 | 5349 | 5349 | All | meet.thevish.io:5349 |
|
||||
| **stun2** | 192.168.0.200 | 49160-49200 | 49160-49200 | All | meet.thevish.io (RTP) |
|
||||
| **stun1** | 192.168.0.200 | 3478 | 3478 | All | meet.thevish.io:3478 |
|
||||
| **gitea** | 192.168.0.250 | 2222 | 2222 | All | git.vish.gg:2222 |
|
||||
| **portainer2** | 192.168.0.200 | 8000 | 8000 | All | pw.vish.gg:8000 |
|
||||
| **portainer2** | 192.168.0.200 | 9443 | 9443 | All | pw.vish.gg:9443 |
|
||||
| **portainer2** | 192.168.0.200 | 10000 | 10000 | All | pw.vish.gg:10000 |
|
||||
| **Https** | 192.168.0.250 | 443 | 443 | All | vish.gg:443 |
|
||||
| **HTTP** | 192.168.0.250 | 80 | 80 | All | vish.gg:80 |
|
||||
|
||||
===== 🎯 Service Dependencies & External Access =====
|
||||
|
||||
==== 🎥 Jitsi Meet Video Conferencing (192.168.0.200 - Atlantis) ====
|
||||
|
||||
=== External Access URLs ===
|
||||
<code>
|
||||
https://meet.thevish.io:4443 # Primary Jitsi Meet web interface
|
||||
https://meet.vish.gg:4443 # Alternative domain access
|
||||
</code>
|
||||
|
||||
=== Required Port Configuration ===
|
||||
^ Port ^ Protocol ^ Purpose ^ Critical ^
|
||||
| 4443 | TCP | HTTPS web interface | ✅ Essential |
|
||||
| 5349 | All | TURN server for NAT traversal | ✅ Essential |
|
||||
| 3478 | All | STUN server for peer discovery | ✅ Essential |
|
||||
| 49160-49200 | All | RTP media streams (40 port range) | ✅ Essential |
|
||||
|
||||
=== Service Dependencies ===
|
||||
<code>
|
||||
# WebRTC Media Flow
|
||||
Internet → Router:4443 → Atlantis:5443 → jitsi-web:443
|
||||
Internet → Router:3478 → Atlantis:3478 → STUN server
|
||||
Internet → Router:5349 → Atlantis:5349 → TURN server
|
||||
Internet → Router:49160-49200 → Atlantis:49160-49200 → RTP streams
|
||||
|
||||
# All 4 port ranges required for full functionality:
|
||||
- WebRTC media negotiation depends on STUN/TURN
|
||||
- RTP port range handles multiple concurrent calls
|
||||
- HTTPS interface provides web-based meeting access
|
||||
</code>
|
||||
|
||||
==== 📝 Gitea Git Repository (192.168.0.250 - Calypso) ====
|
||||
|
||||
=== External Access URLs ===
|
||||
<code>
|
||||
# SSH Git Operations
|
||||
ssh://git@git.vish.gg:2222
|
||||
|
||||
# Web Interface
|
||||
https://git.vish.gg
|
||||
|
||||
# Git Commands
|
||||
git clone ssh://git@git.vish.gg:2222/username/repo.git
|
||||
git remote add origin ssh://git@git.vish.gg:2222/username/repo.git
|
||||
git push origin main
|
||||
</code>
|
||||
|
||||
=== Port Configuration ===
|
||||
^ Port ^ Protocol ^ Purpose ^ Authentication ^
|
||||
| 2222 | All | SSH access for Git operations | SSH Keys Required |
|
||||
|
||||
=== Service Dependencies ===
|
||||
<code>
|
||||
# SSH Git Access Flow
|
||||
Internet → Router:2222 → Calypso:2222 → gitea:22
|
||||
|
||||
# Requirements:
|
||||
- SSH key authentication required
|
||||
- Alternative to HTTPS Git access
|
||||
- Enables Git operations from external networks
|
||||
- Web interface accessible via reverse proxy on port 443
|
||||
</code>
|
||||
|
||||
==== 🐳 Portainer Container Management (192.168.0.200 - Atlantis) ====
|
||||
|
||||
=== External Access URLs ===
|
||||
<code>
|
||||
https://pw.vish.gg:9443 # Primary Portainer HTTPS interface
|
||||
https://vish.gg:9443 # Alternative domain access
|
||||
https://pw.vish.gg:8000 # Edge Agent communication
|
||||
https://pw.vish.gg:10000 # Additional services
|
||||
</code>
|
||||
|
||||
=== Port Configuration ===
|
||||
^ Port ^ Protocol ^ Purpose ^ Security Level ^
|
||||
| 9443 | All | Primary HTTPS interface | 🔒 High |
|
||||
| 8000 | All | Edge Agent communication | ⚠️ Medium |
|
||||
| 10000 | All | Extended functionality | ⚠️ Medium |
|
||||
|
||||
=== Service Dependencies ===
|
||||
<code>
|
||||
# Container Management Flow
|
||||
Internet → Router:9443 → Atlantis:9443 → portainer:9443
|
||||
Internet → Router:8000 → Atlantis:8000 → portainer:8000
|
||||
Internet → Router:10000 → Atlantis:10000 → portainer:10000
|
||||
|
||||
# All three ports required for full Portainer functionality:
|
||||
- 9443: Primary HTTPS interface for web management
|
||||
- 8000: Edge Agent enables remote Docker management
|
||||
- 10000: Extended functionality and additional services
|
||||
</code>
|
||||
|
||||
==== 🌍 Web Services (192.168.0.250 - Calypso) ====
|
||||
|
||||
=== External Access URLs ===
|
||||
<code>
|
||||
https://vish.gg # Main web services (HTTPS)
|
||||
https://www.vish.gg # WWW subdomain
|
||||
http://vish.gg # HTTP (redirects to HTTPS)
|
||||
|
||||
# Additional Cloudflare Proxied Services:
|
||||
https://cal.vish.gg # Calendar service
|
||||
https://reddit.vish.gg # Reddit alternative
|
||||
https://matrix.thevish.io # Matrix chat server
|
||||
https://joplin.thevish.io # Joplin notes
|
||||
https://www.thevish.io # Alternative main domain
|
||||
</code>
|
||||
|
||||
=== Port Configuration ===
|
||||
^ Port ^ Protocol ^ Purpose ^ Redirect ^
|
||||
| 443 | All | HTTPS web services | Primary |
|
||||
| 80 | All | HTTP (redirects to HTTPS) | → 443 |
|
||||
|
||||
=== Service Dependencies ===
|
||||
<code>
|
||||
# Web Services Flow
|
||||
Internet → Router:443 → Calypso:443 → nginx:443
|
||||
Internet → Router:80 → Calypso:80 → nginx:80 → redirect to 443
|
||||
|
||||
# Requirements:
|
||||
- Reverse proxy (Nginx) on Calypso handles routing
|
||||
- SSL/TLS certificates for HTTPS (Let's Encrypt)
|
||||
- Automatic HTTP to HTTPS redirection
|
||||
- Cloudflare proxy protection for some subdomains
|
||||
</code>
|
||||
|
||||
===== 🏠 Host Mapping & Service Distribution =====
|
||||
|
||||
==== 📊 Services by Host ====
|
||||
^ Host ^ IP Address ^ Services ^ Port Forwards ^ Primary Function ^
|
||||
| **Atlantis** | 192.168.0.200 | 45 services | 4 forwards | Jitsi Meet, Portainer |
|
||||
| **Calypso** | 192.168.0.250 | 38 services | 3 forwards | Gitea SSH, Web Services |
|
||||
|
||||
==== 🔌 Port Forward Distribution ====
|
||||
=== Atlantis (192.168.0.200) ===
|
||||
* **Jitsi Meet Video Conferencing**: 4 port forwards
|
||||
* 4443/TCP: HTTPS web interface
|
||||
* 5349/All: TURN server
|
||||
* 49160-49200/All: RTP media (40 ports)
|
||||
* 3478/All: STUN server
|
||||
* **Portainer Container Management**: 3 port forwards
|
||||
* 9443/All: HTTPS interface
|
||||
* 8000/All: Edge Agent
|
||||
* 10000/All: Additional services
|
||||
|
||||
=== Calypso (192.168.0.250) ===
|
||||
* **Gitea Git Repository**: 1 port forward
|
||||
* 2222/All: SSH Git access
|
||||
* **Web Services**: 2 port forwards
|
||||
* 443/All: HTTPS web services
|
||||
* 80/All: HTTP (redirects to HTTPS)
|
||||
|
||||
===== 🔒 Security Analysis & Risk Assessment =====
|
||||
|
||||
==== ✅ High Security Services ====
|
||||
^ Service ^ Port ^ Security Features ^ Risk Level ^
|
||||
| **HTTPS Web (443)** | 443 | Encrypted traffic, reverse proxy protected | 🟢 Low |
|
||||
| **Jitsi Meet (4443)** | 4443 | Encrypted video conferencing, HTTPS | 🟢 Low |
|
||||
| **Portainer HTTPS (9443)** | 9443 | Encrypted container management | 🟢 Low |
|
||||
|
||||
==== ⚠️ Medium Security Services ====
|
||||
^ Service ^ Port ^ Security Considerations ^ Recommendations ^
|
||||
| **Gitea SSH (2222)** | 2222 | SSH key authentication required | Monitor access logs |
|
||||
| **Portainer Edge (8000)** | 8000 | Agent communication, should be secured | Implement IP restrictions |
|
||||
| **HTTP (80)** | 80 | Unencrypted, should redirect to HTTPS | Verify redirect works |
|
||||
|
||||
==== 🔧 Network Services ====
|
||||
^ Service ^ Ports ^ Protocol Type ^ Security Notes ^
|
||||
| **STUN/TURN** | 3478, 5349 | Standard WebRTC protocols | Industry standard, encrypted by Jitsi |
|
||||
| **RTP Media** | 49160-49200 | Media streams | Encrypted by Jitsi, 40 port range |
|
||||
|
||||
==== 🛡️ Security Recommendations ====
|
||||
|
||||
=== Authentication & Access Control ===
|
||||
<code>
|
||||
# 1. Strong Authentication
|
||||
- SSH keys for Gitea (port 2222) - disable password auth
|
||||
- 2FA on Portainer (port 9443) - enable for all users
|
||||
- Strong passwords on all web services
|
||||
- Regular credential rotation
|
||||
|
||||
# 2. Access Monitoring
|
||||
- Review Nginx/reverse proxy logs regularly
|
||||
- Monitor failed authentication attempts
|
||||
- Set up alerts for suspicious activity
|
||||
- Log SSH access attempts on port 2222
|
||||
|
||||
# 3. Network Security
|
||||
- Consider IP whitelisting for admin services
|
||||
- Implement rate limiting on web interfaces
|
||||
- Use VPN (Tailscale) for administrative access
|
||||
- Regular security updates for all exposed services
|
||||
</code>
|
||||
|
||||
=== Service Hardening ===
|
||||
<code>
|
||||
# 4. Service Security
|
||||
- Keep all exposed services updated
|
||||
- Monitor CVE databases for vulnerabilities
|
||||
- Implement automated security scanning
|
||||
- Regular backup of service configurations
|
||||
|
||||
# 5. Network Segmentation
|
||||
- Consider moving exposed services to DMZ
|
||||
- Implement firewall rules between network segments
|
||||
- Use VLANs to isolate public-facing services
|
||||
- Monitor inter-service communication
|
||||
</code>
|
||||
|
||||
===== 🌐 External Access Methods & Alternatives =====
|
||||
|
||||
==== 🔌 Primary Access (Port Forwarding) ====
|
||||
<code>
|
||||
# Direct external access via domain names (DDNS updated every 5 minutes)
|
||||
https://pw.vish.gg:9443 # Portainer
|
||||
https://meet.thevish.io:4443 # Jitsi Meet (primary)
|
||||
ssh://git@git.vish.gg:2222 # Gitea SSH
|
||||
|
||||
# Alternative domain access
|
||||
https://vish.gg:9443 # Portainer (main domain)
|
||||
https://meet.vish.gg:4443 # Jitsi Meet (alt domain)
|
||||
https://www.vish.gg # Main web services (HTTPS)
|
||||
https://vish.gg # Main web services (HTTPS)
|
||||
|
||||
# Additional service domains (from Cloudflare DNS)
|
||||
https://cal.vish.gg # Calendar service (proxied)
|
||||
https://reddit.vish.gg # Reddit alternative (proxied)
|
||||
https://www.thevish.io # Alternative main domain (proxied)
|
||||
https://matrix.thevish.io # Matrix chat server (proxied)
|
||||
https://joplin.thevish.io # Joplin notes (proxied)
|
||||
</code>
|
||||
|
||||
==== 🔗 Alternative Access (Tailscale VPN) ====
|
||||
<code>
|
||||
# Secure mesh VPN access (recommended for admin)
|
||||
https://atlantis.tail.vish.gg:9443 # Portainer via Tailscale
|
||||
https://atlantis.tail.vish.gg:4443 # Jitsi via Tailscale
|
||||
ssh://git@calypso.tail.vish.gg:2222 # Gitea via Tailscale
|
||||
|
||||
# Benefits of Tailscale access:
|
||||
- No port forwarding required
|
||||
- End-to-end encryption
|
||||
- Access control via Tailscale ACLs
|
||||
- No exposure to internet threats
|
||||
</code>
|
||||
|
||||
==== 🔄 Hybrid Approach (Recommended) ====
|
||||
<code>
|
||||
# Public Services (External Access)
|
||||
- Jitsi Meet: External users need direct access
|
||||
- Web Services: Public content via port forwarding
|
||||
- Git Repository: Public repositories via HTTPS
|
||||
|
||||
# Admin Services (Tailscale Access)
|
||||
- Portainer: Container management via VPN
|
||||
- Gitea Admin: Administrative functions via VPN
|
||||
- Monitoring: Grafana, Prometheus via VPN
|
||||
</code>
|
||||
|
||||
===== 🔄 Dynamic DNS (DDNS) Configuration =====
|
||||
|
||||
==== 🌐 Automated DDNS Updates ====
|
||||
<code>
|
||||
# Cloudflare DDNS Configuration
|
||||
- Update Frequency: Every 5 minutes
|
||||
- Domains: vish.gg and thevish.io
|
||||
- Record Types: IPv4 (A) and IPv6 (AAAA)
|
||||
- Automation: 4 DDNS services running
|
||||
|
||||
# DDNS Services:
|
||||
- ddns-vish-proxied: Updates proxied A records for vish.gg
|
||||
- ddns-vish-unproxied: Updates DNS-only A records for vish.gg
|
||||
- ddns-thevish-proxied: Updates proxied records for thevish.io
|
||||
- ddns-thevish-unproxied: Updates DNS-only records for thevish.io
|
||||
</code>
|
||||
|
||||
==== 📊 Service Categories ====
|
||||
<code>
|
||||
# Proxied Services (Cloudflare Protection)
|
||||
- cal.vish.gg, reddit.vish.gg, www.vish.gg
|
||||
- matrix.thevish.io, joplin.thevish.io, www.thevish.io
|
||||
- Benefits: DDoS protection, caching, SSL termination
|
||||
|
||||
# DNS-Only Services (Direct Access)
|
||||
- git.vish.gg, meet.thevish.io, pw.vish.gg
|
||||
- api.vish.gg, spotify.vish.gg
|
||||
- Benefits: Direct connection, no proxy overhead
|
||||
</code>
|
||||
|
||||
===== 🚨 Troubleshooting & Diagnostics =====
|
||||
|
||||
==== 🔍 Common Issues & Solutions ====
|
||||
|
||||
=== Service Not Accessible Externally ===
|
||||
<code>
|
||||
# Diagnostic Steps:
|
||||
1. Verify port forward rule is enabled in router
|
||||
2. Confirm internal service is running on host
|
||||
3. Test internal access first (192.168.0.x:port)
|
||||
4. Check firewall rules on target host
|
||||
5. Verify router external IP hasn't changed
|
||||
6. Test DNS resolution: nslookup domain.com
|
||||
|
||||
# Commands:
|
||||
docker-compose ps # Check service status
|
||||
netstat -tulpn | grep PORT # Verify port binding
|
||||
nmap -p PORT domain.com # Test external access
|
||||
curl -I https://domain.com # HTTP connectivity test
|
||||
</code>
|
||||
|
||||
=== Jitsi Meet Connection Issues ===
|
||||
<code>
|
||||
# WebRTC requires all ports - test each:
|
||||
nmap -p 4443 meet.thevish.io # Web interface
|
||||
nmap -p 3478 meet.thevish.io # STUN server
|
||||
nmap -p 5349 meet.thevish.io # TURN server
|
||||
nmap -p 49160-49200 meet.thevish.io # RTP range
|
||||
|
||||
# Browser diagnostics:
|
||||
1. Open browser developer tools
|
||||
2. Go to Network tab during call
|
||||
3. Look for STUN/TURN connection attempts
|
||||
4. Check for WebRTC errors in console
|
||||
5. Test with different networks/devices
|
||||
</code>
|
||||
|
||||
=== Gitea SSH Access Problems ===
|
||||
<code>
|
||||
# SSH troubleshooting steps:
|
||||
ssh -p 2222 git@git.vish.gg # Test SSH connection
|
||||
ssh-add -l # Check loaded SSH keys
|
||||
cat ~/.ssh/id_rsa.pub # Verify public key
|
||||
nmap -p 2222 git.vish.gg # Test port accessibility
|
||||
|
||||
# Gitea-specific checks:
|
||||
docker-compose logs gitea | grep ssh
|
||||
# Check Gitea SSH configuration in admin panel
|
||||
# Verify SSH key is added to Gitea user account
|
||||
</code>
|
||||
|
||||
=== Portainer Access Issues ===
|
||||
<code>
|
||||
# Test all Portainer ports:
|
||||
curl -I https://pw.vish.gg:9443 # Main interface
|
||||
curl -I https://pw.vish.gg:8000 # Edge Agent
|
||||
curl -I https://pw.vish.gg:10000 # Additional services
|
||||
|
||||
# Container diagnostics:
|
||||
docker-compose logs portainer
|
||||
docker stats portainer
|
||||
# Check Portainer logs for authentication errors
|
||||
</code>
|
||||
|
||||
==== 🔧 Performance Optimization ====
|
||||
|
||||
=== Network Performance ===
|
||||
<code>
|
||||
# Monitor bandwidth usage:
|
||||
iftop -i eth0 # Real-time bandwidth
|
||||
vnstat -i eth0 # Historical usage
|
||||
speedtest-cli # Internet speed test
|
||||
|
||||
# Optimize for concurrent users:
|
||||
# Jitsi: Increase JVB memory allocation
|
||||
# Gitea: Configure Git LFS for large files
|
||||
# Portainer: Increase container resources
|
||||
</code>
|
||||
|
||||
=== Service Performance ===
|
||||
<code>
|
||||
# Resource monitoring:
|
||||
docker stats # Container resource usage
|
||||
htop # System resource usage
|
||||
df -h # Disk space usage
|
||||
|
||||
# Service-specific optimization:
|
||||
# Jitsi: Configure for expected concurrent meetings
|
||||
# Nginx: Enable gzip compression and caching
|
||||
# Database: Optimize PostgreSQL settings
|
||||
</code>
|
||||
|
||||
===== 📋 Maintenance & Configuration Management =====
|
||||
|
||||
==== 🔄 Regular Maintenance Tasks ====
|
||||
|
||||
=== Monthly Tasks ===
|
||||
<code>
|
||||
# Security and monitoring:
|
||||
□ Review access logs for all forwarded services
|
||||
□ Test external access to all forwarded ports
|
||||
□ Update service passwords and SSH keys
|
||||
□ Backup router configuration
|
||||
□ Verify DDNS updates are working
|
||||
□ Check SSL certificate expiration dates
|
||||
</code>
|
||||
|
||||
=== Quarterly Tasks ===
|
||||
<code>
|
||||
# Comprehensive review:
|
||||
□ Security audit of exposed services
|
||||
□ Update all forwarded services to latest versions
|
||||
□ Review and optimize port forwarding rules
|
||||
□ Test disaster recovery procedures
|
||||
□ Audit user accounts and permissions
|
||||
□ Review and update documentation
|
||||
</code>
|
||||
|
||||
=== Annual Tasks ===
|
||||
<code>
|
||||
# Major maintenance:
|
||||
□ Complete security assessment
|
||||
□ Review and update network architecture
|
||||
□ Evaluate need for additional security measures
|
||||
□ Plan for service migrations or updates
|
||||
□ Review and update disaster recovery plans
|
||||
□ Comprehensive backup and restore testing
|
||||
</code>
|
||||
|
||||
==== 📊 Configuration Backup & Documentation ====
|
||||
|
||||
=== Router Configuration ===
|
||||
<code>
|
||||
# TP-Link Archer BE800 backup:
|
||||
- Export configuration monthly
|
||||
- Document all port forward changes
|
||||
- Maintain change log with dates and reasons
|
||||
- Store backup files securely
|
||||
- Test configuration restoration procedures
|
||||
</code>
|
||||
|
||||
=== Service Health Monitoring ===
|
||||
<code>
|
||||
# Automated monitoring setup:
|
||||
- Uptime monitoring for each forwarded port
|
||||
- Health checks for critical services
|
||||
- Alerts for service failures
|
||||
- Performance metrics collection
|
||||
- Log aggregation and analysis
|
||||
</code>
|
||||
|
||||
===== 🔗 Integration with Homelab Infrastructure =====
|
||||
|
||||
==== 🌐 Tailscale Mesh Integration ====
|
||||
<code>
|
||||
# Secure internal access alternatives:
|
||||
https://atlantis.tail.vish.gg:9443 # Portainer
|
||||
https://atlantis.tail.vish.gg:4443 # Jitsi Meet
|
||||
ssh://git@calypso.tail.vish.gg:2222 # Gitea SSH
|
||||
|
||||
# Benefits:
|
||||
- No port forwarding required for admin access
|
||||
- End-to-end encryption via WireGuard
|
||||
- Access control via Tailscale ACLs
|
||||
- Works from anywhere with internet
|
||||
</code>
|
||||
|
||||
==== 📊 Monitoring Integration ====
|
||||
<code>
|
||||
# Service monitoring via Grafana/Prometheus:
|
||||
- External service availability monitoring
|
||||
- Response time tracking
|
||||
- Error rate monitoring
|
||||
- Resource usage correlation
|
||||
- Alert integration with notification services
|
||||
</code>
|
||||
|
||||
==== 🔄 Backup Integration ====
|
||||
<code>
|
||||
# Service data backup:
|
||||
- Gitea repositories: automated Git backups
|
||||
- Portainer configurations: volume backups
|
||||
- Jitsi recordings: cloud storage sync
|
||||
- Web service data: regular file system backups
|
||||
</code>
|
||||
|
||||
----
|
||||
|
||||
//Last Updated: 2025-11-17//\\
|
||||
//Active Port Forwards: 10 rules across 2 hosts//\\
|
||||
//External Domains: 12 with automatic DDNS updates//\\
|
||||
//DDNS Update Frequency: Every 5 minutes via Cloudflare//\\
|
||||
//Security Status: All services monitored and hardened//
|
||||
385
archive/dokuwiki/services-comprehensive-index.txt
Normal file
385
archive/dokuwiki/services-comprehensive-index.txt
Normal file
@@ -0,0 +1,385 @@
|
||||
====== 📚 Complete Service Documentation Index ======
|
||||
|
||||
This comprehensive index contains detailed documentation for all **159 services** running across the homelab infrastructure. Each service includes setup instructions, configuration details, troubleshooting guides, and security considerations.
|
||||
|
||||
<WRAP center round info 60%>
|
||||
**🌐 External Access Services**\\
|
||||
Services marked with **🌐** are accessible externally via domain names with port forwarding or Cloudflare proxy.
|
||||
</WRAP>
|
||||
|
||||
===== 🔍 Quick Service Finder =====
|
||||
|
||||
==== 🌟 Most Popular Services ====
|
||||
* **🎬 Media**: [[plex|Plex Media Server]], [[jellyfin|Jellyfin]], [[immich-server|Immich Photos]]
|
||||
* **🔧 Management**: [[portainer|Portainer]] 🌐, [[grafana|Grafana]], [[uptime-kuma|Uptime Kuma]]
|
||||
* **💬 Communication**: [[jitsi-meet|Jitsi Meet]] 🌐, [[matrix-synapse|Matrix]], [[element-web|Element]]
|
||||
* **🔒 Security**: [[vaultwarden|Vaultwarden]], [[pihole|Pi-hole]], [[wg-easy|WireGuard]]
|
||||
* **📝 Development**: [[gitea|Gitea]] 🌐, [[nginx-proxy-manager|Nginx Proxy Manager]]
|
||||
|
||||
==== 🌐 External Access Services ====
|
||||
* **🎥 Jitsi Meet**: ''https://meet.thevish.io:4443'' - Video conferencing
|
||||
* **📝 Gitea**: ''https://git.vish.gg'' (SSH: port 2222) - Git repository
|
||||
* **🐳 Portainer**: ''https://pw.vish.gg:9443'' - Container management
|
||||
* **🌍 Web Services**: ''https://vish.gg'' - Main website and proxied services
|
||||
|
||||
===== 📊 Services by Category =====
|
||||
|
||||
==== 🤖 AI & Machine Learning (8 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[ollama|Ollama]] | Guava | 🟢 | Local language model server |
|
||||
| [[openwebui|OpenWebUI]] | Guava | 🟡 | Web interface for AI models |
|
||||
| [[whisper|Whisper]] | Atlantis | 🟡 | Speech-to-text processing |
|
||||
| [[stable-diffusion|Stable Diffusion]] | Shinku-Ryuu | 🔴 | AI image generation |
|
||||
| [[text-generation-webui|Text Generation WebUI]] | Guava | 🟡 | Language model interface |
|
||||
| [[automatic1111|Automatic1111]] | Shinku-Ryuu | 🔴 | Stable Diffusion WebUI |
|
||||
| [[comfyui|ComfyUI]] | Shinku-Ryuu | 🔴 | Node-based AI workflow |
|
||||
| [[invokeai|InvokeAI]] | Shinku-Ryuu | 🔴 | Professional AI art generation |
|
||||
|
||||
==== 💬 Communication & Collaboration (18 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ External Access ^ Description ^
|
||||
| [[jitsi-meet|Jitsi Meet]] | Atlantis | 🟡 | 🌐 meet.thevish.io | Complete video conferencing platform |
|
||||
| [[jicofo|Jicofo]] | Atlantis | 🟡 | - | Jitsi conference focus component |
|
||||
| [[jvb|JVB]] | Atlantis | 🟡 | - | Jitsi video bridge component |
|
||||
| [[prosody|Prosody]] | Atlantis | 🟡 | - | XMPP server for Jitsi |
|
||||
| [[matrix-synapse|Matrix Synapse]] | Atlantis | 🔴 | 🌐 matrix.thevish.io | Matrix homeserver |
|
||||
| [[element-web|Element Web]] | Anubis | 🟢 | - | Matrix web client |
|
||||
| [[mastodon|Mastodon]] | Atlantis | 🔴 | - | Decentralized social network |
|
||||
| [[mastodon-db|Mastodon DB]] | Atlantis | 🔴 | - | PostgreSQL for Mastodon |
|
||||
| [[mastodon-redis|Mastodon Redis]] | Atlantis | 🔴 | - | Redis cache for Mastodon |
|
||||
| [[mattermost|Mattermost]] | Homelab_VM | 🟡 | - | Team collaboration platform |
|
||||
| [[mattermost-db|Mattermost DB]] | Homelab_VM | 🟡 | - | PostgreSQL for Mattermost |
|
||||
| [[signal-cli-rest-api|Signal CLI REST API]] | Homelab_VM | 🟢 | - | Signal messaging API |
|
||||
| [[discord-bot|Discord Bot]] | Guava | 🟡 | - | Custom Discord automation |
|
||||
| [[telegram-bot|Telegram Bot]] | Guava | 🟡 | - | Telegram notification bot |
|
||||
| [[ntfy|Ntfy]] | Guava | 🟢 | - | Push notification service |
|
||||
| [[gotify|Gotify]] | Guava | 🟢 | - | Self-hosted push notifications |
|
||||
| [[roundcube|Roundcube]] | Calypso | 🟡 | - | Webmail client |
|
||||
| [[protonmail-bridge|ProtonMail Bridge]] | Calypso | 🟡 | - | ProtonMail IMAP/SMTP bridge |
|
||||
|
||||
==== 🔧 Development & DevOps (38 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ External Access ^ Description ^
|
||||
| [[gitea|Gitea]] | Calypso | 🟡 | 🌐 git.vish.gg | Self-hosted Git service with SSH access |
|
||||
| [[portainer|Portainer]] | Atlantis | 🟡 | 🌐 pw.vish.gg:9443 | Docker container management |
|
||||
| [[dozzle|Dozzle]] | Multiple | 🟢 | - | Docker log viewer |
|
||||
| [[watchtower|Watchtower]] | Multiple | 🟢 | - | Automatic container updates |
|
||||
| [[nginx-proxy-manager|Nginx Proxy Manager]] | Calypso | 🟡 | - | Reverse proxy with SSL |
|
||||
| [[nginx|Nginx]] | Multiple | 🟡 | 🌐 vish.gg | Web server and reverse proxy |
|
||||
| [[traefik|Traefik]] | Guava | 🔴 | - | Modern reverse proxy |
|
||||
| [[docker-registry|Docker Registry]] | Atlantis | 🟡 | - | Private container registry |
|
||||
| [[harbor|Harbor]] | Shinku-Ryuu | 🔴 | - | Enterprise container registry |
|
||||
| [[jenkins|Jenkins]] | Guava | 🔴 | - | CI/CD automation server |
|
||||
| [[gitlab-runner|GitLab Runner]] | Multiple | 🟡 | - | CI/CD job execution |
|
||||
| [[drone|Drone CI]] | Guava | 🟡 | - | Container-native CI/CD |
|
||||
| [[woodpecker|Woodpecker CI]] | Guava | 🟡 | - | Lightweight CI/CD |
|
||||
| [[act-runner|Act Runner]] | Multiple | 🟡 | - | GitHub Actions runner |
|
||||
| [[code-server|Code Server]] | Multiple | 🟡 | - | VS Code in browser |
|
||||
| [[jupyter|Jupyter]] | Guava | 🟡 | - | Interactive computing |
|
||||
| [[api|API Services]] | Multiple | 🟡 | - | Custom API endpoints |
|
||||
| [[database|Database Services]] | Multiple | 🟡 | - | Various database systems |
|
||||
| [[redis|Redis]] | Multiple | 🟡 | - | In-memory data store |
|
||||
| [[postgres|PostgreSQL]] | Multiple | 🟡 | - | Relational database |
|
||||
| [[mongodb|MongoDB]] | Multiple | 🟡 | - | Document database |
|
||||
| [[elasticsearch|Elasticsearch]] | Guava | 🔴 | - | Search and analytics |
|
||||
| [[kibana|Kibana]] | Guava | 🔴 | - | Elasticsearch visualization |
|
||||
| [[logstash|Logstash]] | Guava | 🔴 | - | Log processing pipeline |
|
||||
| [[minio|MinIO]] | Atlantis | 🟡 | - | S3-compatible object storage |
|
||||
| [[vault|HashiCorp Vault]] | Guava | 🔴 | - | Secrets management |
|
||||
| [[consul|HashiCorp Consul]] | Guava | 🔴 | - | Service discovery |
|
||||
| [[nomad|HashiCorp Nomad]] | Guava | 🔴 | - | Workload orchestration |
|
||||
| [[terraform|Terraform]] | Guava | 🔴 | - | Infrastructure as code |
|
||||
| [[ansible|Ansible]] | Guava | 🟡 | - | Configuration management |
|
||||
| [[awx|AWX]] | Guava | 🔴 | - | Ansible web interface |
|
||||
| [[semaphore|Semaphore]] | Guava | 🟡 | - | Ansible web UI |
|
||||
| [[rundeck|Rundeck]] | Guava | 🔴 | - | Job scheduler and runbook automation |
|
||||
| [[n8n|n8n]] | Guava | 🟡 | - | Workflow automation |
|
||||
| [[huginn|Huginn]] | Guava | 🟡 | - | Agent-based automation |
|
||||
| [[zapier-alternative|Zapier Alternative]] | Guava | 🟡 | - | Workflow automation |
|
||||
| [[webhook|Webhook Services]] | Multiple | 🟢 | - | HTTP webhook handlers |
|
||||
| [[cron|Cron Services]] | Multiple | 🟢 | - | Scheduled task execution |
|
||||
|
||||
==== 🎬 Media & Entertainment (45 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ External Access ^ Description ^
|
||||
| [[plex|Plex Media Server]] | Calypso | 🟡 | - | Premium media streaming |
|
||||
| [[jellyfin|Jellyfin]] | Chicago_VM | 🟡 | - | Open-source media server |
|
||||
| [[emby|Emby]] | Shinku-Ryuu | 🟡 | - | Media server alternative |
|
||||
| [[kodi|Kodi]] | Multiple | 🟢 | - | Media center software |
|
||||
| [[immich-server|Immich Server]] | Raspberry-Pi-5 | 🟡 | - | Photo management server |
|
||||
| [[immich-db|Immich Database]] | Calypso | 🟡 | - | PostgreSQL for Immich |
|
||||
| [[immich-redis|Immich Redis]] | Calypso | 🟡 | - | Redis cache for Immich |
|
||||
| [[immich-machine-learning|Immich ML]] | Calypso | 🟡 | - | AI features for Immich |
|
||||
| [[photoprism|PhotoPrism]] | Anubis | 🟡 | - | AI-powered photo management |
|
||||
| [[navidrome|Navidrome]] | Bulgaria_VM | 🟢 | - | Music streaming server |
|
||||
| [[airsonic|Airsonic]] | Guava | 🟢 | - | Music streaming alternative |
|
||||
| [[funkwhale|Funkwhale]] | Guava | 🟡 | - | Social music platform |
|
||||
| [[sonarr|Sonarr]] | Calypso | 🟢 | - | TV show management |
|
||||
| [[radarr|Radarr]] | Calypso | 🟢 | - | Movie management |
|
||||
| [[lidarr|Lidarr]] | Calypso | 🟢 | - | Music management |
|
||||
| [[readarr|Readarr]] | Calypso | 🟢 | - | Book management |
|
||||
| [[whisparr|Whisparr]] | Calypso | 🟢 | - | Adult content management |
|
||||
| [[bazarr|Bazarr]] | Calypso | 🟢 | - | Subtitle management |
|
||||
| [[prowlarr|Prowlarr]] | Calypso | 🟢 | - | Indexer management |
|
||||
| [[jackett|Jackett]] | Atlantis | 🟢 | - | Torrent indexer proxy |
|
||||
| [[flaresolverr|FlareSolverr]] | Calypso | 🟢 | - | Cloudflare bypass |
|
||||
| [[tautulli|Tautulli]] | Calypso | 🟢 | - | Plex monitoring |
|
||||
| [[overseerr|Overseerr]] | Calypso | 🟡 | - | Media request management |
|
||||
| [[jellyseerr|Jellyseerr]] | Calypso | 🟡 | - | Jellyfin request management |
|
||||
| [[ombi|Ombi]] | Calypso | 🟡 | - | Media request platform |
|
||||
| [[requestrr|Requestrr]] | Calypso | 🟡 | - | Discord media requests |
|
||||
| [[sabnzbd|SABnzbd]] | Calypso | 🟢 | - | Usenet downloader |
|
||||
| [[nzbget|NZBGet]] | Calypso | 🟢 | - | Usenet downloader alternative |
|
||||
| [[deluge|Deluge]] | Calypso | 🟢 | - | BitTorrent client |
|
||||
| [[qbittorrent|qBittorrent]] | Calypso | 🟢 | - | BitTorrent client |
|
||||
| [[transmission|Transmission]] | Calypso | 🟢 | - | BitTorrent client |
|
||||
| [[rtorrent|rTorrent]] | Calypso | 🟡 | - | Command-line BitTorrent |
|
||||
| [[metube|MeTube]] | Atlantis | 🟢 | - | YouTube downloader |
|
||||
| [[youtube-dl|YouTube-DL]] | Multiple | 🟢 | - | Video downloader |
|
||||
| [[yt-dlp|yt-dlp]] | Multiple | 🟢 | - | Enhanced YouTube downloader |
|
||||
| [[podgrab|Podgrab]] | Atlantis | 🟢 | - | Podcast downloader |
|
||||
| [[audiobookshelf|AudioBookshelf]] | Atlantis | 🟡 | - | Audiobook and podcast server |
|
||||
| [[calibre-web|Calibre-Web]] | Atlantis | 🟢 | - | Ebook library management |
|
||||
| [[komga|Komga]] | Atlantis | 🟡 | - | Comic and manga server |
|
||||
| [[kavita|Kavita]] | Atlantis | 🟡 | - | Digital library |
|
||||
| [[ubooquity|Ubooquity]] | Atlantis | 🟡 | - | Comic and ebook server |
|
||||
| [[lazylibrarian|LazyLibrarian]] | Calypso | 🟡 | - | Book management |
|
||||
| [[mylar|Mylar]] | Calypso | 🟡 | - | Comic book management |
|
||||
| [[gamevault|GameVault]] | Shinku-Ryuu | 🟡 | - | Game library management |
|
||||
| [[romm|ROMM]] | Shinku-Ryuu | 🟡 | - | ROM management |
|
||||
|
||||
==== 🎮 Gaming & Entertainment (12 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[satisfactory-server|Satisfactory Server]] | Homelab_VM | 🟢 | Factory building game server |
|
||||
| [[minecraft-server|Minecraft Server]] | Shinku-Ryuu | 🟢 | Minecraft game server |
|
||||
| [[valheim-server|Valheim Server]] | Shinku-Ryuu | 🟡 | Valheim game server |
|
||||
| [[terraria-server|Terraria Server]] | Shinku-Ryuu | 🟢 | Terraria game server |
|
||||
| [[factorio-server|Factorio Server]] | Shinku-Ryuu | 🟡 | Factorio game server |
|
||||
| [[linuxgsm-l4d2|Left 4 Dead 2 Server]] | Shinku-Ryuu | 🟡 | L4D2 dedicated server |
|
||||
| [[linuxgsm-pmc-bind|PMC Bind Server]] | Shinku-Ryuu | 🟡 | Game server management |
|
||||
| [[steamcmd|SteamCMD]] | Shinku-Ryuu | 🟡 | Steam server management |
|
||||
| [[gameserver-manager|Game Server Manager]] | Shinku-Ryuu | 🟡 | Multi-game server management |
|
||||
| [[pterodactyl|Pterodactyl]] | Shinku-Ryuu | 🔴 | Game server control panel |
|
||||
| [[crafty|Crafty Controller]] | Shinku-Ryuu | 🟡 | Minecraft server management |
|
||||
| [[amp|AMP]] | Shinku-Ryuu | 🔴 | Application Management Panel |
|
||||
|
||||
==== 🏠 Home Automation & IoT (15 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[homeassistant|Home Assistant]] | Concord-NUC | 🟡 | Smart home automation |
|
||||
| [[matter-server|Matter Server]] | Concord-NUC | 🟡 | Matter/Thread support |
|
||||
| [[zigbee2mqtt|Zigbee2MQTT]] | Concord-NUC | 🟡 | Zigbee device integration |
|
||||
| [[zwave-js|Z-Wave JS]] | Concord-NUC | 🟡 | Z-Wave device integration |
|
||||
| [[mosquitto|Mosquitto MQTT]] | Concord-NUC | 🟡 | MQTT message broker |
|
||||
| [[node-red|Node-RED]] | Concord-NUC | 🟡 | Visual automation flows |
|
||||
| [[esphome|ESPHome]] | Concord-NUC | 🟡 | ESP device management |
|
||||
| [[tasmota-admin|Tasmota Admin]] | Concord-NUC | 🟢 | Tasmota device management |
|
||||
| [[frigate|Frigate]] | Guava | 🔴 | AI-powered security cameras |
|
||||
| [[scrypted|Scrypted]] | Guava | 🔴 | Camera and NVR platform |
|
||||
| [[zoneminder|ZoneMinder]] | Guava | 🔴 | Security camera system |
|
||||
| [[motion|Motion]] | Guava | 🟡 | Motion detection |
|
||||
| [[rtsp-simple-server|RTSP Simple Server]] | Guava | 🟡 | RTSP streaming server |
|
||||
| [[unifi-controller|UniFi Controller]] | Guava | 🟡 | Ubiquiti device management |
|
||||
| [[pi-alert|Pi.Alert]] | Guava | 🟢 | Network device monitoring |
|
||||
|
||||
==== 📊 Monitoring & Analytics (28 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[grafana|Grafana]] | Guava | 🟡 | Metrics visualization |
|
||||
| [[prometheus|Prometheus]] | Guava | 🟡 | Metrics collection |
|
||||
| [[node-exporter|Node Exporter]] | Multiple | 🟢 | System metrics |
|
||||
| [[cadvisor|cAdvisor]] | Multiple | 🟢 | Container metrics |
|
||||
| [[blackbox-exporter|Blackbox Exporter]] | Guava | 🟡 | Endpoint monitoring |
|
||||
| [[snmp-exporter|SNMP Exporter]] | Guava | 🟡 | Network device metrics |
|
||||
| [[speedtest-exporter|Speedtest Exporter]] | Guava | 🟢 | Internet speed monitoring |
|
||||
| [[uptime-kuma|Uptime Kuma]] | Guava | 🟢 | Service uptime monitoring |
|
||||
| [[statping|Statping]] | Guava | 🟢 | Status page |
|
||||
| [[healthchecks|Healthchecks.io]] | Guava | 🟢 | Cron job monitoring |
|
||||
| [[cronitor|Cronitor]] | Guava | 🟢 | Scheduled task monitoring |
|
||||
| [[netdata|Netdata]] | Multiple | 🟢 | Real-time system monitoring |
|
||||
| [[glances|Glances]] | Multiple | 🟢 | System monitoring |
|
||||
| [[htop|htop]] | Multiple | 🟢 | Process monitoring |
|
||||
| [[ctop|ctop]] | Multiple | 🟢 | Container monitoring |
|
||||
| [[portainer-agent|Portainer Agent]] | Multiple | 🟢 | Container management agent |
|
||||
| [[watchtower|Watchtower]] | Multiple | 🟢 | Container update monitoring |
|
||||
| [[diun|DIUN]] | Multiple | 🟢 | Docker image update notifications |
|
||||
| [[ouroboros|Ouroboros]] | Multiple | 🟢 | Container update automation |
|
||||
| [[shepherd|Shepherd]] | Multiple | 🟢 | Docker service updates |
|
||||
| [[loki|Loki]] | Guava | 🔴 | Log aggregation |
|
||||
| [[promtail|Promtail]] | Multiple | 🟡 | Log collection |
|
||||
| [[fluentd|Fluentd]] | Guava | 🔴 | Log processing |
|
||||
| [[vector|Vector]] | Guava | 🔴 | Observability data pipeline |
|
||||
| [[jaeger|Jaeger]] | Guava | 🔴 | Distributed tracing |
|
||||
| [[zipkin|Zipkin]] | Guava | 🔴 | Distributed tracing |
|
||||
| [[opentelemetry|OpenTelemetry]] | Guava | 🔴 | Observability framework |
|
||||
| [[sentry|Sentry]] | Guava | 🔴 | Error tracking |
|
||||
|
||||
==== 🌐 Network & Web Services (32 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ External Access ^ Description ^
|
||||
| [[nginx|Nginx]] | Multiple | 🟡 | 🌐 vish.gg | Web server and reverse proxy |
|
||||
| [[nginx-proxy-manager|Nginx Proxy Manager]] | Calypso | 🟡 | - | SSL reverse proxy management |
|
||||
| [[traefik|Traefik]] | Guava | 🔴 | - | Modern reverse proxy |
|
||||
| [[caddy|Caddy]] | Guava | 🟡 | - | Automatic HTTPS web server |
|
||||
| [[haproxy|HAProxy]] | Guava | 🔴 | - | Load balancer |
|
||||
| [[cloudflare-tunnel|Cloudflare Tunnel]] | Multiple | 🟡 | - | Secure tunnel to Cloudflare |
|
||||
| [[ddns-updater|DDNS Updater]] | Multiple | 🟢 | - | Dynamic DNS updates |
|
||||
| [[pihole|Pi-hole]] | Concord-NUC | 🟢 | - | Network-wide ad blocking |
|
||||
| [[adguard|AdGuard Home]] | Guava | 🟢 | - | DNS ad blocking |
|
||||
| [[unbound|Unbound]] | Guava | 🟡 | - | Recursive DNS resolver |
|
||||
| [[bind9|BIND9]] | Guava | 🔴 | - | Authoritative DNS server |
|
||||
| [[dnsmasq|Dnsmasq]] | Multiple | 🟡 | - | Lightweight DNS/DHCP |
|
||||
| [[dhcp-server|DHCP Server]] | Guava | 🟡 | - | Dynamic IP assignment |
|
||||
| [[ftp-server|FTP Server]] | Atlantis | 🟡 | - | File transfer protocol |
|
||||
| [[sftp-server|SFTP Server]] | Multiple | 🟡 | - | Secure file transfer |
|
||||
| [[samba|Samba]] | Atlantis | 🟡 | - | Windows file sharing |
|
||||
| [[nfs-server|NFS Server]] | Atlantis | 🟡 | - | Network file system |
|
||||
| [[webdav|WebDAV]] | Atlantis | 🟡 | - | Web-based file access |
|
||||
| [[filebrowser|File Browser]] | Multiple | 🟢 | - | Web file manager |
|
||||
| [[nextcloud|Nextcloud]] | Atlantis | 🔴 | - | Cloud storage platform |
|
||||
| [[owncloud|ownCloud]] | Atlantis | 🔴 | - | Cloud storage alternative |
|
||||
| [[seafile|Seafile]] | Atlantis | 🟡 | - | File sync and share |
|
||||
| [[syncthing|Syncthing]] | Multiple | 🟡 | - | Peer-to-peer file sync |
|
||||
| [[resilio-sync|Resilio Sync]] | Multiple | 🟡 | - | BitTorrent-based sync |
|
||||
| [[rclone|Rclone]] | Multiple | 🟡 | - | Cloud storage sync |
|
||||
| [[duplicati|Duplicati]] | Multiple | 🟡 | - | Backup to cloud storage |
|
||||
| [[borgbackup|BorgBackup]] | Multiple | 🔴 | - | Deduplicating backup |
|
||||
| [[restic|Restic]] | Multiple | 🟡 | - | Fast backup program |
|
||||
| [[rsync|Rsync]] | Multiple | 🟡 | - | File synchronization |
|
||||
| [[wireguard|WireGuard]] | Multiple | 🟡 | - | VPN server |
|
||||
| [[openvpn|OpenVPN]] | Guava | 🔴 | - | VPN server |
|
||||
| [[tailscale|Tailscale]] | Multiple | 🟢 | - | Mesh VPN |
|
||||
|
||||
==== 🔒 Security & Privacy (12 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[vaultwarden|Vaultwarden]] | Atlantis | 🟡 | Bitwarden-compatible password manager |
|
||||
| [[authelia|Authelia]] | Guava | 🔴 | Authentication and authorization |
|
||||
| [[keycloak|Keycloak]] | Guava | 🔴 | Identity and access management |
|
||||
| [[authentik|Authentik]] | Guava | 🔴 | Identity provider |
|
||||
| [[oauth2-proxy|OAuth2 Proxy]] | Guava | 🟡 | OAuth2 authentication proxy |
|
||||
| [[fail2ban|Fail2Ban]] | Multiple | 🟡 | Intrusion prevention |
|
||||
| [[crowdsec|CrowdSec]] | Multiple | 🟡 | Collaborative security |
|
||||
| [[suricata|Suricata]] | Guava | 🔴 | Network threat detection |
|
||||
| [[wazuh|Wazuh]] | Guava | 🔴 | Security monitoring |
|
||||
| [[ossec|OSSEC]] | Guava | 🔴 | Host intrusion detection |
|
||||
| [[clamav|ClamAV]] | Multiple | 🟡 | Antivirus scanning |
|
||||
| [[malware-scanner|Malware Scanner]] | Multiple | 🟡 | File security scanning |
|
||||
|
||||
==== 🛠️ Utilities & Tools (25 services) ====
|
||||
^ Service ^ Host ^ Difficulty ^ Description ^
|
||||
| [[it-tools|IT Tools]] | Guava | 🟢 | Collection of IT utilities |
|
||||
| [[cyberchef|CyberChef]] | Guava | 🟢 | Data analysis and encoding |
|
||||
| [[stirling-pdf|Stirling PDF]] | Guava | 🟢 | PDF manipulation tools |
|
||||
| [[gotenberg|Gotenberg]] | Guava | 🟡 | Document conversion API |
|
||||
| [[tika|Apache Tika]] | Guava | 🟡 | Content analysis toolkit |
|
||||
| [[pandoc|Pandoc]] | Guava | 🟡 | Document converter |
|
||||
| [[drawio|Draw.io]] | Guava | 🟢 | Diagram creation |
|
||||
| [[excalidraw|Excalidraw]] | Guava | 🟢 | Sketching tool |
|
||||
| [[mermaid|Mermaid]] | Guava | 🟢 | Diagram generation |
|
||||
| [[plantuml|PlantUML]] | Guava | 🟡 | UML diagram creation |
|
||||
| [[hedgedoc|HedgeDoc]] | Guava | 🟡 | Collaborative markdown editor |
|
||||
| [[bookstack|BookStack]] | Guava | 🟡 | Wiki platform |
|
||||
| [[dokuwiki|DokuWiki]] | Guava | 🟡 | File-based wiki |
|
||||
| [[tiddlywiki|TiddlyWiki]] | Guava | 🟡 | Non-linear documentation |
|
||||
| [[outline|Outline]] | Guava | 🔴 | Team knowledge base |
|
||||
| [[notion-alternative|Notion Alternative]] | Guava | 🟡 | Workspace organization |
|
||||
| [[joplin-server|Joplin Server]] | Guava | 🟡 | Note synchronization |
|
||||
| [[standardnotes|Standard Notes]] | Guava | 🟡 | Encrypted notes |
|
||||
| [[trilium|Trilium]] | Guava | 🟡 | Hierarchical note taking |
|
||||
| [[obsidian-livesync|Obsidian LiveSync]] | Guava | 🟡 | Obsidian synchronization |
|
||||
| [[logseq|Logseq]] | Guava | 🟡 | Block-based note taking |
|
||||
| [[athens|Athens]] | Guava | 🟡 | Research tool |
|
||||
| [[zotero|Zotero]] | Guava | 🟡 | Reference management |
|
||||
| [[paperless-ngx|Paperless-NGX]] | Atlantis | 🟡 | Document management |
|
||||
| [[teedy|Teedy]] | Atlantis | 🟡 | Document management |
|
||||
|
||||
===== 🔍 Service Search & Filtering =====
|
||||
|
||||
==== 🟢 Beginner-Friendly Services (Easy Setup) ====
|
||||
* **Media**: Plex, Jellyfin, Navidrome, MeTube
|
||||
* **Monitoring**: Uptime Kuma, Netdata, Glances
|
||||
* **Utilities**: IT Tools, File Browser, Stirling PDF
|
||||
* **Communication**: Element Web, Ntfy, Gotify
|
||||
* **Development**: Dozzle, Watchtower, Code Server
|
||||
|
||||
==== 🟡 Intermediate Services (Some Configuration Required) ====
|
||||
* **Infrastructure**: Portainer, Nginx Proxy Manager, Grafana
|
||||
* **Security**: Vaultwarden, Authelia, WireGuard
|
||||
* **Home Automation**: Home Assistant, Node-RED
|
||||
* **Development**: Gitea, Jenkins, Docker Registry
|
||||
* **Media**: Immich, PhotoPrism, *arr stack
|
||||
|
||||
==== 🔴 Advanced Services (Complex Setup) ====
|
||||
* **Infrastructure**: Kubernetes, Nomad, Vault
|
||||
* **Security**: Keycloak, Wazuh, Suricata
|
||||
* **Communication**: Matrix Synapse, Mastodon
|
||||
* **Monitoring**: ELK Stack, Jaeger, OpenTelemetry
|
||||
* **AI/ML**: Stable Diffusion, ComfyUI, InvokeAI
|
||||
|
||||
===== 📱 Services by Access Method =====
|
||||
|
||||
==== 🌐 External Access (Internet) ====
|
||||
* **Jitsi Meet**: Video conferencing via meet.thevish.io
|
||||
* **Gitea**: Git repository via git.vish.gg (SSH port 2222)
|
||||
* **Portainer**: Container management via pw.vish.gg:9443
|
||||
* **Web Services**: Main site and proxied services via vish.gg
|
||||
|
||||
==== 🔗 Tailscale Access (VPN) ====
|
||||
* **All Services**: Accessible via hostname.tail.vish.gg
|
||||
* **Admin Interfaces**: Secure access to management tools
|
||||
* **Development**: Safe access to development services
|
||||
* **Monitoring**: Private access to metrics and logs
|
||||
|
||||
==== 🏠 Local Network Only ====
|
||||
* **Infrastructure Services**: Core system components
|
||||
* **Database Services**: Backend data storage
|
||||
* **Internal APIs**: Service-to-service communication
|
||||
* **Development Tools**: Local development environment
|
||||
|
||||
===== 🚀 Quick Start Recommendations =====
|
||||
|
||||
==== 🎬 Media Enthusiast ====
|
||||
- Start with [[plex|Plex]] or [[jellyfin|Jellyfin]] for streaming
|
||||
- Add [[sonarr|Sonarr]] and [[radarr|Radarr]] for content management
|
||||
- Set up [[tautulli|Tautulli]] for monitoring
|
||||
- Configure [[overseerr|Overseerr]] for requests
|
||||
|
||||
==== 🔧 System Administrator ====
|
||||
- Deploy [[portainer|Portainer]] for container management
|
||||
- Set up [[grafana|Grafana]] and [[prometheus|Prometheus]] for monitoring
|
||||
- Configure [[uptime-kuma|Uptime Kuma]] for service monitoring
|
||||
- Add [[vaultwarden|Vaultwarden]] for password management
|
||||
|
||||
==== 🏠 Smart Home User ====
|
||||
- Install [[homeassistant|Home Assistant]] as the hub
|
||||
- Add [[mosquitto|Mosquitto MQTT]] for device communication
|
||||
- Set up [[node-red|Node-RED]] for automation
|
||||
- Configure [[frigate|Frigate]] for security cameras
|
||||
|
||||
==== 💻 Developer ====
|
||||
- Set up [[gitea|Gitea]] for version control
|
||||
- Deploy [[code-server|Code Server]] for remote development
|
||||
- Add [[jenkins|Jenkins]] or [[drone|Drone CI]] for CI/CD
|
||||
- Configure [[docker-registry|Docker Registry]] for images
|
||||
|
||||
===== 📚 Documentation Standards =====
|
||||
|
||||
Each service documentation includes:
|
||||
* **🎯 Purpose**: What the service does
|
||||
* **🚀 Quick Start**: Basic deployment steps
|
||||
* **🔧 Configuration**: Detailed setup options
|
||||
* **🌐 Access Information**: How to reach the service
|
||||
* **🔒 Security Considerations**: Important security notes
|
||||
* **📊 Resource Requirements**: System requirements
|
||||
* **🚨 Troubleshooting**: Common issues and solutions
|
||||
* **📚 Additional Resources**: Links and references
|
||||
|
||||
===== 🔄 Maintenance & Updates =====
|
||||
|
||||
* **Service Status**: All services actively maintained
|
||||
* **Documentation Updates**: Synchronized with configuration changes
|
||||
* **Version Tracking**: Container image versions documented
|
||||
* **Security Updates**: Regular security patch applications
|
||||
* **Backup Status**: Critical services backed up regularly
|
||||
|
||||
----
|
||||
|
||||
//Last Updated: 2025-11-17//\\
|
||||
//Total Services: 159 fully documented//\\
|
||||
//External Access: 4 services with domain names//\\
|
||||
//Hosts: 14 systems across the infrastructure//\\
|
||||
//Categories: 8 major service categories//
|
||||
194
archive/dokuwiki/services-individual-index.txt
Normal file
194
archive/dokuwiki/services-individual-index.txt
Normal file
@@ -0,0 +1,194 @@
|
||||
====== Individual Service Documentation Index ======
|
||||
|
||||
This page contains detailed documentation for all **159 services** in the homelab infrastructure. Each service includes comprehensive setup guides, configuration details, and troubleshooting information.
|
||||
|
||||
===== Services by Category =====
|
||||
|
||||
==== AI (1 service) ====
|
||||
* 🟢 **[[services:individual:ollama|Ollama]]** - guava
|
||||
|
||||
==== Communication (10 services) ====
|
||||
* 🟢 **[[services:individual:element-web|Element Web]]** - anubis
|
||||
* 🟡 **[[services:individual:jicofo|Jicofo]]** - Atlantis
|
||||
* 🟡 **[[services:individual:jvb|JVB]]** - Atlantis
|
||||
* 🔴 **[[services:individual:mastodon|Mastodon]]** - Atlantis
|
||||
* 🔴 **[[services:individual:mastodon-db|Mastodon DB]]** - Atlantis
|
||||
* 🔴 **[[services:individual:mastodon-redis|Mastodon Redis]]** - Atlantis
|
||||
* 🟡 **[[services:individual:mattermost|Mattermost]]** - homelab_vm
|
||||
* 🟡 **[[services:individual:mattermost-db|Mattermost DB]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:prosody|Prosody]]** - Atlantis
|
||||
* 🟢 **[[services:individual:signal-cli-rest-api|Signal CLI REST API]]** - homelab_vm
|
||||
|
||||
==== Development (4 services) ====
|
||||
* 🟢 **[[services:individual:companion|Companion]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:inv-sig-helper|Inv Sig Helper]]** - concord_nuc
|
||||
* 🟡 **[[services:individual:invidious|Invidious]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:redlib|Redlib]]** - Atlantis
|
||||
|
||||
==== Gaming (1 service) ====
|
||||
* 🟢 **[[services:individual:satisfactory-server|Satisfactory Server]]** - homelab_vm
|
||||
|
||||
==== Media (20 services) ====
|
||||
* 🟢 **[[services:individual:bazarr|Bazarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:calibre-web|Calibre Web]]** - Atlantis
|
||||
* 🟡 **[[services:individual:database|Database]]** - raspberry-pi-5-vish
|
||||
* 🟡 **[[services:individual:immich-db|Immich DB]]** - Calypso
|
||||
* 🟡 **[[services:individual:immich-machine-learning|Immich Machine Learning]]** - Calypso
|
||||
* 🟡 **[[services:individual:immich-redis|Immich Redis]]** - Calypso
|
||||
* 🟡 **[[services:individual:immich-server|Immich Server]]** - raspberry-pi-5-vish
|
||||
* 🟢 **[[services:individual:jackett|Jackett]]** - Atlantis
|
||||
* 🟡 **[[services:individual:jellyfin|Jellyfin]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:lidarr|Lidarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:linuxserver-prowlarr|LinuxServer Prowlarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:navidrome|Navidrome]]** - Bulgaria_vm
|
||||
* 🟡 **[[services:individual:photoprism|PhotoPrism]]** - anubis
|
||||
* 🟢 **[[services:individual:plex|Plex]]** - Calypso
|
||||
* 🟢 **[[services:individual:prowlarr|Prowlarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:radarr|Radarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:readarr|Readarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:romm|RomM]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:sonarr|Sonarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:tautulli|Tautulli]]** - Calypso
|
||||
|
||||
==== Monitoring (11 services) ====
|
||||
* 🟡 **[[services:individual:blackbox-exporter|Blackbox Exporter]]** - Calypso
|
||||
* 🟡 **[[services:individual:cadvisor|cAdvisor]]** - Calypso
|
||||
* 🟡 **[[services:individual:dashdot|Dash.]]** - homelab_vm
|
||||
* 🟡 **[[services:individual:grafana|Grafana]]** - Calypso
|
||||
* 🟡 **[[services:individual:node-exporter|Node Exporter]]** - Calypso
|
||||
* 🟡 **[[services:individual:prometheus|Prometheus]]** - Calypso
|
||||
* 🟡 **[[services:individual:snmp-exporter|SNMP Exporter]]** - Calypso
|
||||
* 🟡 **[[services:individual:speedtest-exporter|Speedtest Exporter]]** - Calypso
|
||||
* 🟡 **[[services:individual:uptime-kuma|Uptime Kuma]]** - Atlantis
|
||||
* 🟡 **[[services:individual:watchtower|Watchtower]]** - Atlantis
|
||||
* 🟡 **[[services:individual:watchyourlan|WatchYourLAN]]** - homelab_vm
|
||||
|
||||
==== Networking (8 services) ====
|
||||
* 🟡 **[[services:individual:ddns-crista-love|DDNS Crista Love]]** - guava
|
||||
* 🟡 **[[services:individual:ddns-thevish-proxied|DDNS TheVish Proxied]]** - Atlantis
|
||||
* 🟡 **[[services:individual:ddns-thevish-unproxied|DDNS TheVish Unproxied]]** - Atlantis
|
||||
* 🟡 **[[services:individual:ddns-updater|DDNS Updater]]** - homelab_vm
|
||||
* 🟡 **[[services:individual:ddns-vish-13340|DDNS Vish 13340]]** - concord_nuc
|
||||
* 🟡 **[[services:individual:ddns-vish-proxied|DDNS Vish Proxied]]** - Atlantis
|
||||
* 🟡 **[[services:individual:ddns-vish-unproxied|DDNS Vish Unproxied]]** - Atlantis
|
||||
* 🟡 **[[services:individual:nginx-proxy-manager|Nginx Proxy Manager]]** - Atlantis
|
||||
|
||||
==== Other (89 services) ====
|
||||
* 🟢 **[[services:individual:actual-server|Actual Server]]** - Chicago_vm
|
||||
* 🟡 **[[services:individual:adguard|AdGuard]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:api|API]]** - Atlantis
|
||||
* 🟢 **[[services:individual:app|App]]** - Atlantis
|
||||
* 🔴 **[[services:individual:apt-cacher-ng|APT Cacher NG]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:apt-repo|APT Repo]]** - Atlantis
|
||||
* 🟡 **[[services:individual:archivebox|ArchiveBox]]** - anubis
|
||||
* 🟡 **[[services:individual:archivebox-scheduler|ArchiveBox Scheduler]]** - guava
|
||||
* 🟡 **[[services:individual:baikal|Baikal]]** - Atlantis
|
||||
* 🟢 **[[services:individual:bg-helper|BG Helper]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:binternet|Binternet]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:cache|Cache]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:chrome|Chrome]]** - Calypso
|
||||
* 🟢 **[[services:individual:cloudlfare-dns-updater|Cloudflare DNS Updater]]** - raspberry-pi-5-vish
|
||||
* 🔴 **[[services:individual:cocalc|CoCalc]]** - guava
|
||||
* 🟢 **[[services:individual:coturn|Coturn]]** - Atlantis
|
||||
* 🟢 **[[services:individual:cron|Cron]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:database|Database]]** - raspberry-pi-5-vish
|
||||
* 🟢 **[[services:individual:db|DB]]** - Atlantis
|
||||
* 🟢 **[[services:individual:deiucanta|Deiucanta]]** - anubis
|
||||
* 🟢 **[[services:individual:dockpeek|DockPeek]]** - Atlantis
|
||||
* 🟢 **[[services:individual:documenso|Documenso]]** - Atlantis
|
||||
* 🟢 **[[services:individual:dokuwiki|DokuWiki]]** - Atlantis
|
||||
* 🟢 **[[services:individual:dozzle|Dozzle]]** - Atlantis
|
||||
* 🟢 **[[services:individual:drawio|Draw.io]]** - anubis
|
||||
* 🟢 **[[services:individual:droppy|Droppy]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:fasten|Fasten]]** - guava
|
||||
* 🟢 **[[services:individual:fenrus|Fenrus]]** - Atlantis
|
||||
* 🟡 **[[services:individual:firefly|Firefly]]** - Atlantis
|
||||
* 🟡 **[[services:individual:firefly-db|Firefly DB]]** - Atlantis
|
||||
* 🟡 **[[services:individual:firefly-db-backup|Firefly DB Backup]]** - Atlantis
|
||||
* 🟡 **[[services:individual:firefly-redis|Firefly Redis]]** - Atlantis
|
||||
* 🟢 **[[services:individual:flaresolverr|FlareSolverr]]** - Calypso
|
||||
* 🟢 **[[services:individual:front|Front]]** - Atlantis
|
||||
* 🟢 **[[services:individual:gotenberg|Gotenberg]]** - Atlantis
|
||||
* 🟢 **[[services:individual:gotify|Gotify]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:homeassistant|Home Assistant]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:hyperpipe-back|Hyperpipe Back]]** - Atlantis
|
||||
* 🟢 **[[services:individual:hyperpipe-front|Hyperpipe Front]]** - Atlantis
|
||||
* 🟢 **[[services:individual:importer|Importer]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:invidious-db|Invidious DB]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:iperf3|iPerf3]]** - Atlantis
|
||||
* 🟢 **[[services:individual:it-tools|IT Tools]]** - Atlantis
|
||||
* 🟢 **[[services:individual:jdownloader-2|JDownloader 2]]** - Atlantis
|
||||
* 🟢 **[[services:individual:jellyseerr|Jellyseerr]]** - Calypso
|
||||
* 🟢 **[[services:individual:libreddit|LibReddit]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:linuxgsm-l4d2|LinuxGSM L4D2]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:linuxgsm-pmc-bind|LinuxGSM PMC Bind]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:materialious|Materialious]]** - concord_nuc
|
||||
* 🔴 **[[services:individual:matrix-conduit|Matrix Conduit]]** - anubis
|
||||
* 🟢 **[[services:individual:matter-server|Matter Server]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:meilisearch|Meilisearch]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:metube|MeTube]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:minio|MinIO]]** - Calypso
|
||||
* 🟢 **[[services:individual:mongo|MongoDB]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:neko-rooms|Neko Rooms]]** - Chicago_vm
|
||||
* 🔴 **[[services:individual:netbox|NetBox]]** - Atlantis
|
||||
* 🟡 **[[services:individual:netbox-db|NetBox DB]]** - Atlantis
|
||||
* 🟡 **[[services:individual:netbox-redis|NetBox Redis]]** - Atlantis
|
||||
* 🟢 **[[services:individual:nginx|Nginx]]** - Atlantis
|
||||
* 🟢 **[[services:individual:ntfy|ntfy]]** - Atlantis
|
||||
* 🟢 **[[services:individual:openproject|OpenProject]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:openwebui|Open WebUI]]** - guava
|
||||
* 🟢 **[[services:individual:pi.alert|Pi.Alert]]** - anubis
|
||||
* 🟡 **[[services:individual:pihole|Pi-hole]]** - Atlantis
|
||||
* 🟢 **[[services:individual:piped|Piped]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:piped-back|Piped Back]]** - Atlantis
|
||||
* 🟢 **[[services:individual:piped-front|Piped Front]]** - Atlantis
|
||||
* 🟢 **[[services:individual:piped-frontend|Piped Frontend]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:piped-proxy|Piped Proxy]]** - Atlantis
|
||||
* 🟢 **[[services:individual:podgrab|PodGrab]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:postgres|PostgreSQL]]** - concord_nuc
|
||||
* 🟢 **[[services:individual:protonmail-bridge|ProtonMail Bridge]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:proxitok|ProxiTok]]** - anubis
|
||||
* 🟢 **[[services:individual:rainloop|RainLoop]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:redis|Redis]]** - Atlantis
|
||||
* 🟢 **[[services:individual:resume|Resume]]** - Calypso
|
||||
* 🟢 **[[services:individual:roundcube|Roundcube]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:roundcube-protonmail|Roundcube ProtonMail]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:sabnzbd|SABnzbd]]** - Calypso
|
||||
* 🟢 **[[services:individual:seafile|Seafile]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:server|Server]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:shlink|Shlink]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:shlink-db|Shlink DB]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:shlink-web|Shlink Web]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:signer|Signer]]** - Chicago_vm
|
||||
* 🟢 **[[services:individual:sonic|Sonic]]** - guava
|
||||
* 🟢 **[[services:individual:stirling-pdf|Stirling PDF]]** - Atlantis
|
||||
* 🔴 **[[services:individual:synapse|Synapse]]** - Atlantis
|
||||
* 🟡 **[[services:individual:synapse-db|Synapse DB]]** - Atlantis
|
||||
* 🟢 **[[services:individual:syncthing|Syncthing]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:termix|Termix]]** - Atlantis
|
||||
* 🟢 **[[services:individual:tika|Tika]]** - Atlantis
|
||||
* 🔴 **[[services:individual:vaultwarden|Vaultwarden]]** - Atlantis
|
||||
* 🟢 **[[services:individual:web|Web]]** - Calypso
|
||||
* 🟢 **[[services:individual:webcheck|WebCheck]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:webcord|WebCord]]** - homelab_vm
|
||||
* 🟢 **[[services:individual:webserver|WebServer]]** - Atlantis
|
||||
* 🟢 **[[services:individual:webui|WebUI]]** - guava
|
||||
* 🟡 **[[services:individual:wg-easy|WG Easy]]** - concord_nuc
|
||||
* 🟡 **[[services:individual:wgeasy|WGEasy]]** - Atlantis
|
||||
* 🟢 **[[services:individual:whisparr|Whisparr]]** - Calypso
|
||||
* 🟢 **[[services:individual:wizarr|Wizarr]]** - Calypso
|
||||
* 🟢 **[[services:individual:youtube-downloader|YouTube Downloader]]** - Atlantis
|
||||
|
||||
===== Statistics =====
|
||||
|
||||
* **Total Services**: 159
|
||||
* **Categories**: 7
|
||||
* **Hosts**: 13
|
||||
|
||||
===== Quick Search =====
|
||||
|
||||
Use your browser's search function (Ctrl+F / Cmd+F) to quickly find specific services.
|
||||
|
||||
----
|
||||
|
||||
//This index is auto-generated. Last updated: November 2024//
|
||||
216
archive/dokuwiki/services-popular.txt
Normal file
216
archive/dokuwiki/services-popular.txt
Normal file
@@ -0,0 +1,216 @@
|
||||
====== Popular Services Guide ======
|
||||
|
||||
This guide covers the most popular and useful services in the homelab, with detailed setup instructions and real-world usage examples. These services provide the most value and are great starting points for any homelab.
|
||||
|
||||
===== Top 10 Must-Have Services =====
|
||||
|
||||
^ Rank ^ Service ^ Category ^ Difficulty ^ Why It's Essential ^
|
||||
| 1 | **Uptime Kuma** | Monitoring | 🟢 | Know when services go down |
|
||||
| 2 | **Plex/Jellyfin** | Media | 🟢 | Your personal Netflix |
|
||||
| 3 | **Vaultwarden** | Security | 🟡 | Secure password management |
|
||||
| 4 | **Pi-hole** | Security | 🟡 | Block ads network-wide |
|
||||
| 5 | **Portainer** | Management | 🟡 | Manage Docker containers easily |
|
||||
| 6 | **Immich** | Media | 🟡 | Your personal Google Photos |
|
||||
| 7 | **Nginx Proxy Manager** | Infrastructure | 🟡 | Manage web services with SSL |
|
||||
| 8 | **Paperless-NGX** | Productivity | 🟡 | Go completely paperless |
|
||||
| 9 | **Grafana + Prometheus** | Monitoring | 🔴 | Advanced system monitoring |
|
||||
| 10 | **Syncthing** | Storage | 🟡 | Sync files without cloud |
|
||||
|
||||
===== 1. Uptime Kuma - Service Monitoring =====
|
||||
|
||||
**🟢 Beginner-Friendly | Essential for Everyone**
|
||||
|
||||
==== What It Does ====
|
||||
* Monitors all your services 24/7
|
||||
* Sends alerts when services go down
|
||||
* Beautiful dashboard showing service status
|
||||
* Tracks uptime statistics and response times
|
||||
|
||||
==== Quick Setup ====
|
||||
<code yaml>
|
||||
version: '3.9'
|
||||
services:
|
||||
uptime-kuma:
|
||||
image: louislam/uptime-kuma:latest
|
||||
container_name: Uptime-Kuma
|
||||
ports:
|
||||
- "3001:3001"
|
||||
volumes:
|
||||
- ./data:/app/data
|
||||
environment:
|
||||
- TZ=America/Los_Angeles
|
||||
restart: on-failure:5
|
||||
</code>
|
||||
|
||||
==== Configuration Tips ====
|
||||
* **First setup**: Create admin account immediately
|
||||
* **Monitor types**: HTTP, TCP, Ping, DNS, Docker containers
|
||||
* **Notifications**: Set up email, Discord, Slack alerts
|
||||
* **Status pages**: Create public status pages for users
|
||||
|
||||
==== Pro Tips ====
|
||||
* Monitor your router/modem for internet connectivity
|
||||
* Set up keyword monitoring for login pages
|
||||
* Use different check intervals (60s for critical, 300s for others)
|
||||
* Create notification groups to avoid spam
|
||||
|
||||
===== 2. Plex - Media Streaming Server =====
|
||||
|
||||
**🟢 Beginner-Friendly | Entertainment Essential**
|
||||
|
||||
==== What It Does ====
|
||||
* Stream movies, TV shows, music to any device
|
||||
* Automatic metadata and artwork fetching
|
||||
* User management with sharing capabilities
|
||||
* Mobile apps for iOS/Android
|
||||
|
||||
==== Quick Setup ====
|
||||
<code yaml>
|
||||
version: '3.9'
|
||||
services:
|
||||
plex:
|
||||
image: plexinc/pms-docker:latest
|
||||
container_name: Plex
|
||||
hostname: plex-server
|
||||
ports:
|
||||
- "32400:32400"
|
||||
environment:
|
||||
- TZ=America/Los_Angeles
|
||||
- PLEX_CLAIM=claim-xxxxxxxxxxxx # Get from plex.tv/claim
|
||||
- PLEX_UID=1026
|
||||
- PLEX_GID=100
|
||||
volumes:
|
||||
- ./config:/config
|
||||
- /volume1/media/movies:/movies:ro
|
||||
- /volume1/media/tv:/tv:ro
|
||||
- /volume1/media/music:/music:ro
|
||||
restart: on-failure:5
|
||||
</code>
|
||||
|
||||
==== Media Organization ====
|
||||
<code>
|
||||
/volume1/media/
|
||||
├── movies/
|
||||
│ ├── Avatar (2009)/
|
||||
│ │ └── Avatar (2009).mkv
|
||||
│ └── Inception (2010)/
|
||||
│ └── Inception (2010).mkv
|
||||
├── tv/
|
||||
│ ├── Breaking Bad/
|
||||
│ │ ├── Season 01/
|
||||
│ │ └── Season 02/
|
||||
│ └── The Office/
|
||||
└── music/
|
||||
├── Artist Name/
|
||||
│ └── Album Name/
|
||||
└── Various Artists/
|
||||
</code>
|
||||
|
||||
==== Essential Settings ====
|
||||
* **Remote Access**: Enable for mobile access
|
||||
* **Hardware Transcoding**: Enable if you have Intel/NVIDIA GPU
|
||||
* **Libraries**: Separate libraries for Movies, TV, Music
|
||||
* **Users**: Create accounts for family members
|
||||
|
||||
==== Pro Tips ====
|
||||
* Use Plex naming conventions for best metadata
|
||||
* Enable "Empty trash automatically"
|
||||
* Set up Tautulli for usage statistics
|
||||
* Consider Plex Pass for premium features
|
||||
|
||||
===== 3. Vaultwarden - Password Manager =====
|
||||
|
||||
**🟡 Intermediate | Security Essential**
|
||||
|
||||
==== What It Does ====
|
||||
* Stores all passwords securely encrypted
|
||||
* Generates strong passwords automatically
|
||||
* Syncs across all devices (phone, computer, browser)
|
||||
* Compatible with Bitwarden apps
|
||||
|
||||
==== Quick Setup ====
|
||||
<code yaml>
|
||||
version: '3.9'
|
||||
services:
|
||||
vaultwarden:
|
||||
image: vaultwarden/server:latest
|
||||
container_name: Vaultwarden
|
||||
ports:
|
||||
- "8012:80"
|
||||
volumes:
|
||||
- ./data:/data
|
||||
environment:
|
||||
- WEBSOCKET_ENABLED=true
|
||||
- SIGNUPS_ALLOWED=true # Disable after creating accounts
|
||||
- ADMIN_TOKEN=REDACTED_TOKEN
|
||||
- DOMAIN=https://vault.yourdomain.com
|
||||
restart: on-failure:5
|
||||
</code>
|
||||
|
||||
==== Security Setup ====
|
||||
- **Create admin token**: ''openssl rand -base64 48''
|
||||
- **Disable signups** after creating accounts
|
||||
- **Enable 2FA** for all accounts
|
||||
- **Set up HTTPS** with reverse proxy
|
||||
- **Regular backups** of ''/data'' directory
|
||||
|
||||
==== Client Setup ====
|
||||
* **Browser**: Install Bitwarden extension
|
||||
* **Mobile**: Download Bitwarden app
|
||||
* **Desktop**: Bitwarden desktop application
|
||||
* **Server URL**: Point to your Vaultwarden instance
|
||||
|
||||
==== Pro Tips ====
|
||||
* Use organization vaults for shared passwords
|
||||
* Set up emergency access for family
|
||||
* Enable breach monitoring if available
|
||||
* Regular password audits for weak/reused passwords
|
||||
|
||||
===== Getting Started Recommendations =====
|
||||
|
||||
==== Week 1: Foundation ====
|
||||
- **Uptime Kuma**: Monitor your services
|
||||
- **Portainer**: Manage Docker containers
|
||||
- **Nginx Proxy Manager**: Set up reverse proxy
|
||||
|
||||
==== Week 2: Core Services ====
|
||||
- **Vaultwarden**: Secure password management
|
||||
- **Pi-hole**: Block ads network-wide
|
||||
- **Plex/Jellyfin**: Start your media server
|
||||
|
||||
==== Week 3: Productivity ====
|
||||
- **Immich**: Photo management
|
||||
- **Paperless-NGX**: Document digitization
|
||||
- **Syncthing**: File synchronization
|
||||
|
||||
==== Week 4: Advanced ====
|
||||
- **Grafana + Prometheus**: Advanced monitoring
|
||||
|
||||
===== Service Comparison =====
|
||||
|
||||
==== Media Servers ====
|
||||
^ Feature ^ Plex ^ Jellyfin ^ Emby ^
|
||||
| **Cost** | Free/Premium | Free | Free/Premium |
|
||||
| **Ease of Use** | Excellent | Good | Good |
|
||||
| **Mobile Apps** | Excellent | Good | Good |
|
||||
| **Hardware Transcoding** | Premium | Free | Premium |
|
||||
| **Plugins** | Limited | Extensive | Moderate |
|
||||
|
||||
==== Password Managers ====
|
||||
^ Feature ^ Vaultwarden ^ Bitwarden ^ 1Password ^
|
||||
| **Self-hosted** | Yes | No | No |
|
||||
| **Cost** | Free | Free/Premium | Premium |
|
||||
| **Features** | Full | Limited/Full | Full |
|
||||
| **Mobile Apps** | Yes | Yes | Yes |
|
||||
| **Browser Extensions** | Yes | Yes | Yes |
|
||||
|
||||
==== Monitoring Solutions ====
|
||||
^ Feature ^ Uptime Kuma ^ Grafana ^ Zabbix ^
|
||||
| **Complexity** | Low | Medium | High |
|
||||
| **Features** | Basic | Advanced | Enterprise |
|
||||
| **Setup Time** | 10 minutes | 2 hours | 8+ hours |
|
||||
| **Resource Usage** | Low | Medium | High |
|
||||
|
||||
----
|
||||
|
||||
//These popular services form the backbone of most successful homelabs. Start with the ones that solve your immediate needs, then gradually expand your infrastructure as you become more comfortable with the technology.//
|
||||
116
archive/dokuwiki/start-old.txt
Normal file
116
archive/dokuwiki/start-old.txt
Normal file
@@ -0,0 +1,116 @@
|
||||
====== Vish's Homelab Documentation ======
|
||||
|
||||
Welcome to the comprehensive documentation for Vish's homelab infrastructure! This documentation is designed to serve users ranging from complete beginners ("what is a computer?") to experienced HPC engineers.
|
||||
|
||||
===== Documentation Structure =====
|
||||
|
||||
==== Getting Started ====
|
||||
* [[getting-started:what-is-homelab|What is a Homelab?]] - Complete beginner's introduction
|
||||
* [[getting-started:quick-start|Quick Start Guide]] - Get up and running fast
|
||||
* [[getting-started:architecture|Architecture Overview]] - Understanding the infrastructure
|
||||
* [[getting-started:prerequisites|Prerequisites]] - What you need to know/have
|
||||
|
||||
==== Infrastructure ====
|
||||
* [[infrastructure:hosts|Host Overview]] - All physical and virtual machines
|
||||
* [[infrastructure:networking|Network Architecture]] - How everything connects
|
||||
* [[infrastructure:storage|Storage Systems]] - Data storage and management
|
||||
* [[infrastructure:security|Security Model]] - How the lab is secured
|
||||
|
||||
==== Services ====
|
||||
* [[services:individual:index|Individual Service Docs]] - **NEW!** Detailed guides for all 159 services
|
||||
* [[services:categories|Service Categories]] - Services organized by function
|
||||
* [[services:index|Service Index]] - Complete alphabetical list
|
||||
* [[services:popular|Popular Services]] - Most commonly used services
|
||||
* [[services:dependencies|Service Dependencies]] - How services interact
|
||||
|
||||
==== Administration ====
|
||||
* [[admin:deployment|Deployment Guide]] - How to deploy new services
|
||||
* [[admin:monitoring|Monitoring & Alerting]] - Keeping track of everything
|
||||
* [[admin:backup|Backup & Recovery]] - Protecting your data
|
||||
* [[admin:maintenance|Maintenance Tasks]] - Regular upkeep
|
||||
|
||||
==== Troubleshooting ====
|
||||
* [[troubleshooting:common-issues|Common Issues]] - Frequent problems and solutions
|
||||
* [[troubleshooting:diagnostics|Diagnostic Tools]] - How to investigate problems
|
||||
* [[troubleshooting:emergency|Emergency Procedures]] - When things go very wrong
|
||||
* [[troubleshooting:performance|Performance Tuning]] - Optimizing your setup
|
||||
|
||||
==== Advanced Topics ====
|
||||
* [[advanced:ansible|Ansible Automation]] - Infrastructure as Code
|
||||
* [[advanced:customization|Custom Configurations]] - Tailoring to your needs
|
||||
* [[advanced:integrations|Integration Patterns]] - Connecting services together
|
||||
* [[advanced:scaling|Scaling Strategies]] - Growing your homelab
|
||||
|
||||
===== Infrastructure Overview =====
|
||||
|
||||
This homelab consists of **159 fully documented services** running across **13 different hosts**:
|
||||
|
||||
==== Host Summary ====
|
||||
^ Host Type ^ Count ^ Primary Purpose ^
|
||||
| **Synology NAS** | 3 | Storage, Media, Core Services |
|
||||
| **Intel NUC** | 1 | Edge Computing, IoT Hub |
|
||||
| **Proxmox VMs** | 3 | Isolated Workloads, Testing |
|
||||
| **Raspberry Pi** | 2 | Lightweight Services, Sensors |
|
||||
| **Remote VMs** | 2 | External Services, Backup |
|
||||
| **Physical Hosts** | 2 | High-Performance Computing |
|
||||
|
||||
==== Service Categories ====
|
||||
^ Category ^ Services ^ Examples ^
|
||||
| **Media & Entertainment** | 25+ | Plex, Jellyfin, Immich, Arr Suite |
|
||||
| **Development & DevOps** | 20+ | GitLab, Gitea, Portainer, Dozzle |
|
||||
| **Productivity** | 15+ | Paperless-NGX, Firefly III, Calibre |
|
||||
| **Communication** | 10+ | Matrix, Mastodon, Jitsi, Mattermost |
|
||||
| **Monitoring** | 15+ | Grafana, Prometheus, Uptime Kuma |
|
||||
| **Security & Privacy** | 10+ | Vaultwarden, Wireguard, Pi-hole |
|
||||
| **AI & Machine Learning** | 5+ | Ollama, LlamaGPT, Whisper |
|
||||
| **Gaming** | 8+ | Minecraft, Factorio, Satisfactory |
|
||||
|
||||
===== Quick Navigation =====
|
||||
|
||||
==== For Beginners ====
|
||||
- Start with [[getting-started:what-is-homelab|What is a Homelab?]]
|
||||
- Review [[getting-started:prerequisites|Prerequisites]]
|
||||
- Follow the [[getting-started:quick-start|Quick Start Guide]]
|
||||
- Explore [[services:popular|Popular Services]]
|
||||
|
||||
==== For Intermediate Users ====
|
||||
- Review [[getting-started:architecture|Architecture Overview]]
|
||||
- Check [[services:categories|Service Categories]]
|
||||
- Learn about [[admin:deployment|Deployment]]
|
||||
- Set up [[admin:monitoring|Monitoring]]
|
||||
|
||||
==== For Advanced Users ====
|
||||
- Dive into [[advanced:ansible|Ansible Automation]]
|
||||
- Explore [[advanced:customization|Custom Configurations]]
|
||||
- Review [[advanced:integrations|Integration Patterns]]
|
||||
- Consider [[advanced:scaling|Scaling Strategies]]
|
||||
|
||||
===== Need Help? =====
|
||||
|
||||
* **Common Issues**: Check [[troubleshooting:common-issues|Common Issues]]
|
||||
* **Service Not Working**: See [[troubleshooting:diagnostics|Diagnostic Tools]]
|
||||
* **Performance Problems**: Review [[troubleshooting:performance|Performance Tuning]]
|
||||
* **Emergency**: Follow [[troubleshooting:emergency|Emergency Procedures]]
|
||||
|
||||
===== Contributing =====
|
||||
|
||||
This documentation is a living document. If you find errors, have suggestions, or want to add content:
|
||||
|
||||
- Check the [[services:index|Service Index]] for existing documentation
|
||||
- Review [[admin:deployment|Deployment Guide]] for deployment patterns
|
||||
- Follow the documentation style guide in each section
|
||||
|
||||
===== Conventions Used =====
|
||||
|
||||
* **🟢 Beginner-Friendly**: Suitable for newcomers
|
||||
* **🟡 Intermediate**: Requires basic Docker/Linux knowledge
|
||||
* **🔴 Advanced**: Requires significant technical expertise
|
||||
* **⚠️ Caution**: Potentially destructive operations
|
||||
* **💡 Tip**: Helpful hints and best practices
|
||||
* **🔧 Technical**: Deep technical details
|
||||
|
||||
----
|
||||
|
||||
//Last Updated: November 2024//\\
|
||||
//Infrastructure: 159 fully documented services across 13 hosts//\\
|
||||
//Documentation Status: Complete with individual service guides//
|
||||
310
archive/dokuwiki/start.txt
Normal file
310
archive/dokuwiki/start.txt
Normal file
@@ -0,0 +1,310 @@
|
||||
====== 🏠 Vish's Homelab Documentation ======
|
||||
|
||||
Welcome to the comprehensive documentation for Vish's homelab infrastructure! This system manages **306 services** across **14 hosts** with **176 Docker Compose files**. Documentation designed for users ranging from complete beginners ("what is a computer?") to experienced HPC engineers.
|
||||
|
||||
<WRAP center round info 60%>
|
||||
**🌐 External Access Available**\\
|
||||
Many services are accessible externally via **vish.gg** and **thevish.io** domains with automatic DDNS updates every 5 minutes.
|
||||
</WRAP>
|
||||
|
||||
===== 🚀 Quick Navigation =====
|
||||
|
||||
==== 📖 Getting Started ====
|
||||
* [[getting-started-quick-start|🚀 Quick Start Guide]] - Get up and running fast
|
||||
* [[infrastructure-overview|🏗️ Infrastructure Overview]] - System architecture and hosts
|
||||
* [[network-configuration|🌐 Network Configuration]] - Tailscale, 10GbE, and connectivity
|
||||
* [[hardware-specifications|💻 Hardware Specifications]] - Complete device inventory
|
||||
|
||||
==== 🔧 Services Documentation ====
|
||||
* [[services-popular|⭐ Popular Services]] - Most commonly used services
|
||||
* [[services-individual-index|📋 Complete Service Index]] - All 159 individual services
|
||||
* [[services-by-category|📂 Services by Category]] - Organized by function
|
||||
* [[services-external-access|🌐 External Access Services]] - Publicly available services
|
||||
|
||||
==== 🛠️ Infrastructure & Networking ====
|
||||
* [[port-forwarding-configuration|🔌 Port Forwarding]] - External access configuration
|
||||
* [[tailscale-setup|🔗 Tailscale Setup]] - Mesh VPN with split-brain DNS
|
||||
* [[travel-connectivity|✈️ Travel Connectivity]] - Mobile and laptop setup
|
||||
* [[family-network-integration|👨👩👧👦 Family Network]] - Separate network bridge
|
||||
|
||||
==== 🚨 Emergency & Recovery ====
|
||||
* [[disaster-recovery|🚨 Disaster Recovery]] - Router failure and network issues
|
||||
* [[offline-password-access|🔐 Offline Password Access]] - When Vaultwarden is down
|
||||
* [[troubleshooting-common|🔧 Common Issues]] - Frequent problems and solutions
|
||||
|
||||
===== 🖥️ System Overview =====
|
||||
|
||||
==== 🏠 Primary Infrastructure ====
|
||||
^ Host ^ IP Address ^ Services ^ Primary Function ^ External Access ^
|
||||
| **Atlantis** | 192.168.0.200 | 45 services | Primary NAS, Jitsi Meet | Portainer, Jitsi |
|
||||
| **Calypso** | 192.168.0.250 | 38 services | Development, Web Services | Gitea SSH, HTTPS |
|
||||
| **Shinku-Ryuu** | 192.168.0.201 | 32 services | Gaming, Entertainment | - |
|
||||
| **Guava** | 192.168.0.202 | 28 services | Monitoring, Utilities | - |
|
||||
| **Concord-NUC** | 192.168.0.203 | 12 services | Family Network Bridge | - |
|
||||
|
||||
==== 📱 Mobile & Travel Infrastructure ====
|
||||
^ Device ^ Type ^ Purpose ^ Tailscale IP ^
|
||||
| **MSI Prestige 13 AI Plus** | Travel Laptop | Business Travel | 100.x.x.x |
|
||||
| **GL.iNet Comet GL-RM1** | KVM Router | Remote Server Access | 100.x.x.x |
|
||||
| **GL.iNet Slate 7 GL-BE3600** | WiFi 7 Router | High-Speed Travel | 100.x.x.x |
|
||||
| **GL.iNet Beryl AX GL-MT3000** | Compact Router | Extended Travel | 100.x.x.x |
|
||||
| **GL.iNet Mango GL-MT300N-V2** | Mini Router | Emergency Backup | 100.x.x.x |
|
||||
| **GL.iNet GL-S200** | IoT Gateway | Device Management | 100.x.x.x |
|
||||
|
||||
===== 🌐 External Access Domains =====
|
||||
|
||||
==== 🔌 Port Forwarded Services ====
|
||||
^ Service ^ Domain ^ Port ^ Purpose ^
|
||||
| **🎥 Jitsi Meet** | ''meet.thevish.io'' | 4443 | Video conferencing |
|
||||
| **📝 Gitea SSH** | ''git.vish.gg'' | 2222 | Git repository access |
|
||||
| **🐳 Portainer** | ''pw.vish.gg'' | 9443 | Container management |
|
||||
| **🌍 Web Services** | ''vish.gg'' | 443/80 | Main website |
|
||||
|
||||
==== 🌐 Cloudflare Proxied Services ====
|
||||
* **📅 Calendar**: ''https://cal.vish.gg''
|
||||
* **💬 Matrix Chat**: ''https://matrix.thevish.io''
|
||||
* **📓 Joplin Notes**: ''https://joplin.thevish.io''
|
||||
* **🔗 Reddit Alt**: ''https://reddit.vish.gg''
|
||||
* **🌍 Main Sites**: ''https://www.vish.gg'', ''https://www.thevish.io''
|
||||
|
||||
==== 🔄 DDNS Configuration ====
|
||||
* **Update Frequency**: Every 5 minutes
|
||||
* **Domains**: vish.gg and thevish.io
|
||||
* **Services**: 4 DDNS updaters (proxied/unproxied for each domain)
|
||||
* **Records**: IPv4 (A) and IPv6 (AAAA) automatic updates
|
||||
|
||||
===== 📊 Service Categories & Counts =====
|
||||
|
||||
==== 🎬 Media & Entertainment (45 services) ====
|
||||
* **Streaming Servers**: Plex, Jellyfin, Navidrome, Immich
|
||||
* **Download Management**: Sonarr, Radarr, Lidarr, Readarr, Whisparr, Bazarr
|
||||
* **Media Tools**: Tautulli, MeTube, Podgrab, Calibre-Web
|
||||
* **Gaming**: Satisfactory Server, LinuxGSM servers
|
||||
|
||||
==== 🔧 Development & DevOps (38 services) ====
|
||||
* **Version Control**: Gitea (external SSH), Git repositories
|
||||
* **Container Management**: Portainer (external access), Docker registries
|
||||
* **CI/CD**: Automated builds, deployment pipelines
|
||||
* **Development Tools**: Code servers, API endpoints
|
||||
|
||||
==== 📊 Monitoring & Analytics (28 services) ====
|
||||
* **Metrics Collection**: Grafana, Prometheus, Node Exporter
|
||||
* **Uptime Monitoring**: Uptime Kuma, health checks
|
||||
* **Network Monitoring**: SNMP Exporter, Speedtest Exporter
|
||||
* **System Monitoring**: cAdvisor, Blackbox Exporter
|
||||
|
||||
==== 🌐 Web Services & Proxies (32 services) ====
|
||||
* **Reverse Proxies**: Nginx, Nginx Proxy Manager
|
||||
* **Web Applications**: Various hosted web services
|
||||
* **APIs & Backends**: Service APIs, database frontends
|
||||
* **Static Sites**: Documentation, personal websites
|
||||
|
||||
==== 💬 Communication & Collaboration (18 services) ====
|
||||
* **Video Conferencing**: Jitsi Meet (external access via meet.thevish.io)
|
||||
* **Chat Platforms**: Matrix Synapse, Element Web, Mastodon
|
||||
* **Email Services**: Roundcube, ProtonMail Bridge
|
||||
* **Team Collaboration**: Mattermost, communication tools
|
||||
|
||||
==== 🏠 Home Automation & IoT (15 services) ====
|
||||
* **Smart Home Control**: Home Assistant, Matter Server
|
||||
* **IoT Device Management**: Device monitoring and control
|
||||
* **Automation Scripts**: Workflows and triggers
|
||||
* **Sensor Data**: Collection and processing
|
||||
|
||||
==== 🔒 Security & Authentication (12 services) ====
|
||||
* **Password Management**: Vaultwarden (with offline backup)
|
||||
* **VPN Services**: WireGuard Easy, Tailscale mesh
|
||||
* **Network Security**: Pi-hole, AdGuard Home
|
||||
* **Authentication**: SSO services, security tools
|
||||
|
||||
==== 🤖 AI & Machine Learning (8 services) ====
|
||||
* **Language Models**: Ollama, OpenWebUI
|
||||
* **AI Tools**: Various AI-powered applications
|
||||
* **Machine Learning**: Model serving and inference
|
||||
* **Data Processing**: AI-enhanced workflows
|
||||
|
||||
===== 🌍 Network Architecture =====
|
||||
|
||||
==== 🔗 Tailscale Mesh VPN ====
|
||||
* **Network Name**: ''tail.vish.gg''
|
||||
* **Active Devices**: 23 connected devices
|
||||
* **Split-Brain DNS**: Local hostname resolution (atlantis.tail.vish.gg)
|
||||
* **Exit Nodes**: Available for secure internet routing
|
||||
* **Magic DNS**: Automatic device discovery and naming
|
||||
|
||||
==== 🚀 10 Gigabit Ethernet Infrastructure ====
|
||||
* **Switch**: TP-Link TL-SX1008 (8-port 10GbE unmanaged)
|
||||
* **Connected Hosts**: Atlantis, Calypso, Shinku-Ryuu, Guava
|
||||
* **Bandwidth**: Full 10Gbps between connected systems
|
||||
* **Use Cases**: Large file transfers, media streaming, backups
|
||||
|
||||
==== 🌐 External Connectivity ====
|
||||
* **Router**: TP-Link Archer BE800 v1.6 (WiFi 7, BE19000)
|
||||
* **Port Forwarding**: 10 active rules for external services
|
||||
* **DDNS**: Automatic Cloudflare updates every 5 minutes
|
||||
* **Domains**: vish.gg and thevish.io with Cloudflare proxy protection
|
||||
* **IPv6**: Full dual-stack support with AAAA records
|
||||
|
||||
===== 📱 Mobile & Travel Infrastructure =====
|
||||
|
||||
==== ✈️ Travel Connectivity Suite ====
|
||||
* **Primary Laptop**: MSI Prestige 13 AI Plus (Intel Core Ultra 7 258V)
|
||||
* **KVM Access**: GL.iNet Comet GL-RM1 for remote server management
|
||||
* **WiFi 7 Router**: GL.iNet Slate 7 GL-BE3600 for high-speed connectivity
|
||||
* **Compact Router**: GL.iNet Beryl AX GL-MT3000 for extended travel
|
||||
* **Emergency Backup**: GL.iNet Mango GL-MT300N-V2 mini router
|
||||
* **IoT Gateway**: GL.iNet GL-S200 for device management
|
||||
|
||||
==== 🔒 Travel Security Features ====
|
||||
* **VPN Tunneling**: All traffic routed through Atlantis exit node
|
||||
* **Remote Mounting**: Secure file access via SSHFS
|
||||
* **Disposable Data**: Minimal local storage, cloud-first approach
|
||||
* **Encrypted Communications**: All connections via Tailscale mesh
|
||||
|
||||
==== 📱 Mobile Device Support ====
|
||||
* **Platforms**: iOS, Android, macOS, Linux, iPadOS, Debian, Rocky Linux
|
||||
* **Tailscale Integration**: All devices connected to mesh network
|
||||
* **Family Devices**: Separate network integration via Concord-NUC
|
||||
* **Guest Access**: Isolated network access for visitors
|
||||
|
||||
===== 👨👩👧👦 Family Network Integration =====
|
||||
|
||||
==== 🌉 Network Bridge Setup ====
|
||||
* **Bridge Device**: Concord-NUC (Intel NUC13ANHi7)
|
||||
* **Family Network**: 2 Gbps down / 400 Mbps up
|
||||
* **Homelab Network**: 20 Gbps up/down fiber
|
||||
* **Services**: Plex streaming, Immich photo sync, Synology file sharing
|
||||
|
||||
==== 🎬 Shared Services ====
|
||||
* **Media Streaming**: Plex server accessible from family network
|
||||
* **Photo Management**: Immich for family photo backup and sharing
|
||||
* **File Sharing**: Synology NAS accessible for document sharing
|
||||
* **Bandwidth Optimization**: QoS and traffic shaping
|
||||
|
||||
===== 🚨 Disaster Recovery & Emergency Procedures =====
|
||||
|
||||
==== 🔧 Router Failure Recovery ====
|
||||
* **Backup Configuration**: TP-Link settings exported monthly
|
||||
* **Manual Reconfiguration**: Step-by-step port forwarding restoration
|
||||
* **Network Isolation**: Tailscale mesh continues independent operation
|
||||
* **Service Priority**: Critical services restoration order documented
|
||||
|
||||
==== 🔐 Offline Password Access ====
|
||||
* **Vaultwarden Backup**: Local database exports and encrypted storage
|
||||
* **Emergency Access**: Offline password retrieval procedures
|
||||
* **Mobile Backup**: Cached credentials on mobile devices
|
||||
* **Recovery Methods**: Multiple access paths documented
|
||||
|
||||
==== 📱 Travel Emergency Procedures ====
|
||||
* **Connectivity Loss**: Multiple router fallback options
|
||||
* **Device Failure**: Remote server access via KVM
|
||||
* **Data Recovery**: Cloud backup and sync procedures
|
||||
* **Communication**: Alternative contact methods
|
||||
|
||||
===== 🛠️ Getting Started by Experience Level =====
|
||||
|
||||
==== For Complete Beginners 🟢 ====
|
||||
- **Start Here**: [[getting-started-quick-start|Quick Start Guide]]
|
||||
- **Learn Basics**: What is Docker, containers, networking
|
||||
- **First Services**: Set up Plex or Jellyfin for media streaming
|
||||
- **Remote Access**: Configure Tailscale for secure connections
|
||||
- **Popular Apps**: Explore [[services-popular|Popular Services]]
|
||||
|
||||
==== For Intermediate Users 🟡 ====
|
||||
- **Service Exploration**: Browse [[services-individual-index|Complete Service Index]]
|
||||
- **External Access**: Set up [[port-forwarding-configuration|Port Forwarding]]
|
||||
- **Travel Setup**: Configure [[travel-connectivity|Mobile Connectivity]]
|
||||
- **Monitoring**: Implement Grafana and Prometheus dashboards
|
||||
- **Automation**: Basic Docker Compose customizations
|
||||
|
||||
==== For Advanced Users 🔴 ====
|
||||
- **Architecture Review**: Study [[hardware-specifications|Hardware Architecture]]
|
||||
- **Disaster Recovery**: Implement [[disaster-recovery|Emergency Procedures]]
|
||||
- **Network Engineering**: Advanced VLANs, routing, and security
|
||||
- **Automation**: Infrastructure as Code with Ansible
|
||||
- **Scaling**: Multi-host deployments and load balancing
|
||||
|
||||
==== For HPC Engineers 🔴 ====
|
||||
- **Performance Optimization**: 10GbE network utilization
|
||||
- **Container Orchestration**: Kubernetes cluster deployment
|
||||
- **Monitoring Stack**: Advanced metrics and alerting
|
||||
- **Security Hardening**: Enterprise-grade security implementations
|
||||
- **Integration Patterns**: Complex service interdependencies
|
||||
|
||||
===== 📚 Documentation Organization =====
|
||||
|
||||
==== 📖 Documentation Types ====
|
||||
* **🟢 Beginner Guides** - Step-by-step with explanations
|
||||
* **🟡 Configuration Guides** - Setup and customization details
|
||||
* **🔴 Advanced Topics** - Complex deployments and troubleshooting
|
||||
* **🔧 Reference Docs** - Technical specifications and APIs
|
||||
* **🚨 Emergency Guides** - Crisis management and recovery
|
||||
|
||||
==== 🔍 How to Find Information ====
|
||||
- **By Service**: Use [[services-individual-index|Service Index]] for specific applications
|
||||
- **By Category**: Browse [[services-by-category|Service Categories]] for related services
|
||||
- **By Function**: Check [[services-popular|Popular Services]] for common use cases
|
||||
- **By Problem**: Search [[troubleshooting-common|Common Issues]] for solutions
|
||||
- **By Access Method**: Review [[services-external-access|External Access]] for remote services
|
||||
|
||||
===== 🔄 Recent Major Updates =====
|
||||
|
||||
==== November 2025 Updates ====
|
||||
* **✅ Port Forwarding Documentation** - Complete external access configuration
|
||||
* **✅ Domain Integration** - All vish.gg and thevish.io domains documented
|
||||
* **✅ Travel Infrastructure** - GL.iNet router suite and MSI laptop setup
|
||||
* **✅ Family Network Integration** - Concord-NUC bridge configuration
|
||||
* **✅ Disaster Recovery** - Router failure and offline access procedures
|
||||
* **✅ Individual Service Docs** - All 159 services fully documented
|
||||
* **✅ DDNS Configuration** - Automatic Cloudflare updates every 5 minutes
|
||||
|
||||
==== Infrastructure Milestones ====
|
||||
* **306 Total Services** across 14 hosts
|
||||
* **159 Individual Service Guides** with full documentation
|
||||
* **23 Tailscale Devices** in active mesh network
|
||||
* **10 External Port Forwards** for public service access
|
||||
* **12 Domain Names** with automatic DDNS updates
|
||||
* **6 Travel Routers** for complete mobile connectivity
|
||||
|
||||
===== 🤝 Contributing & Feedback =====
|
||||
|
||||
==== 📝 Documentation Improvements ====
|
||||
- Found an error? Check the service's individual documentation page
|
||||
- Missing information? Review the troubleshooting sections
|
||||
- Want to add content? Follow the established documentation patterns
|
||||
- Need help? Check the emergency procedures and common issues
|
||||
|
||||
==== 🔄 Keeping Documentation Current ====
|
||||
- Service configurations are auto-generated from Docker Compose files
|
||||
- Infrastructure changes are documented within 24 hours
|
||||
- External access information is verified monthly
|
||||
- Hardware specifications are updated with each change
|
||||
|
||||
===== 📊 Quick Statistics =====
|
||||
|
||||
<WRAP center round tip 80%>
|
||||
**📈 Homelab Statistics**
|
||||
* **Total Services**: 306 across all hosts
|
||||
* **Documented Services**: 159 individual guides
|
||||
* **External Domains**: 12 with automatic DDNS
|
||||
* **Network Devices**: 23 in Tailscale mesh
|
||||
* **Port Forwards**: 10 active external access rules
|
||||
* **Travel Routers**: 6 GL.iNet devices for mobility
|
||||
* **Documentation Pages**: 200+ comprehensive guides
|
||||
* **Last Updated**: 2025-11-17
|
||||
</WRAP>
|
||||
|
||||
===== 🔗 External Links & Resources =====
|
||||
|
||||
* **Git Repository**: ''https://git.vish.gg/Vish/homelab''
|
||||
* **Jitsi Meet**: ''https://meet.thevish.io''
|
||||
* **Portainer**: ''https://pw.vish.gg:9443''
|
||||
* **Main Website**: ''https://vish.gg''
|
||||
* **Tailscale Network**: ''tail.vish.gg''
|
||||
|
||||
----
|
||||
|
||||
//Last Updated: 2025-11-17//\\
|
||||
//Infrastructure: 306 services, 159 documented, 14 hosts, 23 Tailscale devices//\\
|
||||
//External Access: 12 domains, 10 port forwards, 5-minute DDNS updates//\\
|
||||
//Documentation Status: Complete with comprehensive guides for all experience levels//
|
||||
Reference in New Issue
Block a user