Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/wlfogle/blendos-awesome-stack

🚀 BlendOS Ultimate Media Stack v2.0 - AI-enhanced deployment of 65+ services optimized for BlendOS immutable architecture
https://github.com/wlfogle/blendos-awesome-stack

List: blendos-awesome-stack

ai-enhanced automation blendos container-stack docker-compose grafana homelab immutable-os jellyfin media-server media-stack plex portainer prometheus prowlarr radarr self-hosted sonarr traefik vpn

Last synced: 5 months ago
JSON representation

🚀 BlendOS Ultimate Media Stack v2.0 - AI-enhanced deployment of 65+ services optimized for BlendOS immutable architecture

Awesome Lists containing this project

README 

          
# 🚀 BlendOS Awesome Stack



[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![BlendOS](https://img.shields.io/badge/Platform-blendOS-blue.svg)](https://blendos.co/)

[![Podman](https://img.shields.io/badge/Container-Podman-892CA0.svg)](https://podman.io/)

[![Status](https://img.shields.io/badge/Status-Alpha-orange.svg)]()



**The definitive container-first self-hosting solution designed specifically for blendOS's immutable architecture.**



BlendOS Awesome Stack combines the stability of immutable systems with the power of containerized services to create a comprehensive, maintainable, and scalable infrastructure platform.



## 🌟 **Why BlendOS Awesome Stack?**



### **🏗️ Built for Immutable Systems**

- **Container-First Design**: Everything runs in containers, never modifies the immutable base

- **Declarative Configuration**: System state entirely defined in YAML

- **Atomic Updates**: Changes are either fully applied or not at all

- **Rollback Safety**: Easy system recovery and state management



### **⚡ Optimized for Modern Hardware**

- **Intel + NVIDIA Acceleration**: Full hardware transcoding support

- **Multi-Core Utilization**: Designed for high-performance systems

- **Memory Efficient**: Smart resource allocation across services

- **Remote Management**: Built for headless server operation



### **🔧 Modular Architecture**

Choose exactly what you need:

- 🎬 **Media Stack**: Plex, Jellyfin, *arr services

- 💻 **Development Stack**: Code environments, databases, CI/CD

- 📊 **Monitoring Stack**: Grafana, Prometheus, system metrics

- 📋 **Productivity Stack**: Vaultwarden, NextCloud, office tools

- 🌐 **Networking Stack**: VPN, reverse proxy, network services



---



## 🚀 **Quick Start**



### ✨ **Enhanced One-Line Installation (Recommended)**

```bash

# 🎆 Ultimate Media Stack with automatic dependency installation

bash <(curl -sL https://raw.githubusercontent.com/wlfogle/blendos-awesome-stack/master/scripts/install-media-stack.sh)



# ⚙️ Or enhanced rebuild script (manual deps)

bash <(curl -sL https://raw.githubusercontent.com/wlfogle/blendos-awesome-stack/master/scripts/rebuild-ultimate-stack-enhanced.sh)

```



**✅ The enhanced installer automatically:**

- Detects BlendOS system and optimizes for immutable architecture

- Installs missing dependencies (Docker, Docker Compose, curl, etc.)

- Configures 65+ services across 6 deployment phases

- Sets up VPN-secured downloads and monitoring

- Creates management dashboards and shortcuts



### **Traditional Repository Installation**

```bash

# Clone the repository

git clone https://github.com/wlfogle/blendos-awesome-stack

cd blendos-awesome-stack



# Install media stack only (recommended for first time)

sudo ./scripts/install.sh



# Or install everything

sudo ./scripts/install.sh --all

```



### **Preview Before Installing**

```bash

# See what would be installed without making changes

sudo ./scripts/install.sh --dry-run --all

```



---



## 📦 **Available Stacks**



### 🎬 **Media Stack** (Default)

Complete media server solution with hardware acceleration:



| Service | Purpose | Port | Status |

|---------|---------|------|--------|

| **Plex** | Media server with transcoding | `:32400` | ✅ Ready |

| **Jellyfin** | Open-source media server | `:8096` | ✅ Ready |

| **Sonarr** | TV series management | `:8989` | ✅ Ready |

| **Radarr** | Movie management | `:7878` | ✅ Ready |

| **Lidarr** | Music management | `:8686` | ✅ Ready |

| **Readarr** | Book management | `:8787` | ✅ Ready |

| **qBittorrent** | Download client | `:8080` | ✅ Ready |

| **Prowlarr** | Indexer management | `:9696` | ✅ Ready |

| **Jackett** | Additional indexers | `:9117` | ✅ Ready |

| **Overseerr** | Request management | `:5055` | ✅ Ready |

| **Ombi** | Alternative requests | `:3579` | ✅ Ready |

| **Tautulli** | Plex analytics | `:8181` | ✅ Ready |



### 📋 **Productivity Stack**

Self-hosted productivity and collaboration tools:



| Service | Purpose | Port | Status |

|---------|---------|------|--------|

| **Vaultwarden** | Password manager (Bitwarden) | `:8088` | ✅ Ready |

| **NextCloud** | Cloud storage & sync | `:8089` | ✅ Ready |

| **OnlyOffice** | Office suite | `:8082` | 🚧 Planned |

| **Joplin Server** | Note taking | `:8083` | 🚧 Planned |

| **Kanboard** | Project management | `:8084` | 🚧 Planned |

| **Matrix** | Communication | `:8085` | 🚧 Planned |

| **BookStack** | Wiki/documentation | `:8087` | 🚧 Planned |



### 💻 **Development Stack** (Coming Soon)

Complete development environment:

- **Code Server**: VS Code in browser

- **GitLab/Gitea**: Git repository hosting

- **PostgreSQL/MySQL**: Database services

- **Redis**: Caching and sessions

- **Jenkins**: CI/CD pipelines



### 📊 **Monitoring Stack** (Coming Soon)

System monitoring and alerting:

- **Grafana**: Metrics visualization

- **Prometheus**: Metrics collection

- **Uptime Kuma**: Service monitoring

- **ELK Stack**: Log management



### 🌐 **Networking Stack** (Coming Soon)

Network services and security:

- **WireGuard**: VPN server

- **Traefik**: Reverse proxy

- **Fail2Ban**: Security monitoring



---



## 🛠️ **Installation Options**



### **Individual Stacks**

```bash

# Media stack only (default)

sudo ./scripts/install.sh --media



# Add productivity tools

sudo ./scripts/install.sh --media --productivity



# Development environment

sudo ./scripts/install.sh --development --monitoring

```



### **Hardware Options**

```bash

# Disable GPU acceleration

sudo ./scripts/install.sh --no-gpu



# Disable VNC/remote desktop

sudo ./scripts/install.sh --no-vnc



# Skip dependency installation

sudo ./scripts/install.sh --skip-deps

```



---



## 🔧 **Management**



### **Service Control**

```bash

# Check status of all stacks

awesome-stack status



# Start/stop individual stacks

awesome-stack media start

awesome-stack productivity stop

awesome-stack all restart



# Quick access to logs

awesome-stack media logs

awesome-stack productivity logs plex

```



### **System Information**

```bash

# Comprehensive system status

awesome-stack status



# Hardware monitoring

awesome-stack hardware



# Container resource usage

awesome-stack resources

```



---



## 🌐 **Access Your Services**



After installation, access your services through these URLs:



### **Media Services**

- 🎬 **Plex**: http://localhost:32400/web

- 🎥 **Jellyfin**: http://localhost:8096

- 📺 **Sonarr**: http://localhost:8989

- 🎬 **Radarr**: http://localhost:7878

- ⬇️ **qBittorrent**: http://localhost:8080

- 📝 **Overseerr**: http://localhost:5055



### **Productivity Services**

- 🔐 **Vaultwarden**: http://localhost:8088

- ☁️ **NextCloud**: http://localhost:8089



### **Remote Access**

- 🖥️ **VNC**: `vnc://localhost:5999`

- 🌐 **Web VNC**: http://localhost:6099 (Password: `awesomestack123`)



---



## 🏗️ **Architecture**



### **System Design**

```

blendOS Host (Immutable)

├── Podman Containers

│   ├── Media Stack (:8000-8999)

│   ├── Productivity Stack (:8000-8999)

│   ├── Development Stack (:9000-9999)

│   ├── Monitoring Stack (:3000-3999)

│   └── Networking Stack (:1000-1999)

├── Virtual Displays (VNC)

│   ├── :99-:108 (Xvfb + VNC + noVNC)

│   └── Web Access (:6099-6108)

└── GPU Passthrough (Looking Glass)

    ├── Intel iGPU (Transcoding)

    └── NVIDIA RTX (Gaming/Compute)

```



### **Container Strategy**

- **Isolated Networks**: Each stack runs in its own network

- **Shared Volumes**: Media and download directories shared

- **Resource Limits**: CPU and memory limits per service

- **Health Checks**: Automatic service monitoring

- **Auto-Restart**: Services restart on failure



---



## 📋 **System Requirements**



### **Minimum Requirements**

- **OS**: blendOS (latest)

- **CPU**: 4+ cores

- **RAM**: 8GB+

- **Storage**: 100GB+ available

- **Network**: Stable internet connection



### **Recommended Hardware**

- **CPU**: Intel i7/i9 or AMD Ryzen 7/9

- **RAM**: 32GB+ (our test system: 62GB)

- **GPU**: Intel iGPU + dedicated GPU for transcoding

- **Storage**: NVMe SSD + bulk storage drives

- **Network**: Gigabit+ connection



### **Our Test Configuration**

- **CPU**: Intel i9-13900HX (32 threads) ✅

- **RAM**: 62GB DDR5 ✅

- **GPU**: NVIDIA RTX 4080 + Intel iGPU ✅

- **Storage**: Multiple NVMe drives

- **Network**: Gigabit fiber connection



---



## 🔒 **Security**



### **Built-in Security Features**

- **Container Isolation**: Services can't access host system

- **Network Segmentation**: Isolated container networks

- **Regular Updates**: Automated container updates

- **Secure Defaults**: Security-focused default configurations

- **VPN Ready**: Built-in VPN server support



### **Recommended Security Steps**

1. **Change Default Passwords**: Update all default passwords

2. **Enable 2FA**: Use Vaultwarden for 2FA storage

3. **Network Security**: Configure firewall rules

4. **Regular Backups**: Set up automated backups

5. **Monitor Logs**: Review system and container logs



---



## 📚 **Documentation**



- 📖 **[Installation Guide](docs/INSTALLATION.md)**: Step-by-step setup

- ⚙️ **[Configuration](docs/CONFIGURATION.md)**: Detailed configuration options

- 🔧 **[Troubleshooting](docs/TROUBLESHOOTING.md)**: Common issues and solutions

- 🏗️ **[Architecture](docs/ARCHITECTURE.md)**: Technical architecture details

- 🗺️ **[Project Plan](PROJECT_PLAN.md)**: Development roadmap



---



## 🤝 **Contributing**



We welcome contributions! Here's how you can help:



### **Ways to Contribute**

- 🐛 **Bug Reports**: Found an issue? Let us know!

- 💡 **Feature Requests**: Have ideas for improvements?

- 📝 **Documentation**: Help improve our docs

- 🧪 **Testing**: Test on different hardware configurations

- 💻 **Code**: Submit pull requests for new features



### **Development Setup**

```bash

# Fork and clone the repository

git clone https://github.com/yourusername/blendos-awesome-stack

cd blendos-awesome-stack



# Create a feature branch

git checkout -b feature/amazing-new-feature



# Make your changes and test

sudo ./scripts/install.sh --dry-run



# Submit a pull request

```



---



## 📊 **Project Status**



### **Current Phase**: Alpha Development 🚧



| Stack | Status | Completion |

|-------|--------|------------|

| **Media** | ✅ Ready | 100% |

| **Productivity** | 🚧 In Progress | 60% |

| **Development** | 📋 Planned | 0% |

| **Monitoring** | 📋 Planned | 0% |

| **Networking** | 📋 Planned | 0% |



### **Upcoming Milestones**

- **v0.2.0**: Complete productivity stack

- **v0.3.0**: Development environment

- **v0.4.0**: Monitoring and alerting

- **v0.5.0**: Networking services

- **v1.0.0**: Stable release



---



## ❓ **FAQ**



### **Q: Why blendOS specifically?**

A: blendOS's immutable architecture provides excellent stability for long-running services while the container support makes it perfect for self-hosting.



### **Q: Can I run this on other distributions?**

A: This stack is optimized for blendOS. While the containers will work elsewhere, the installation and management scripts are blendOS-specific.



### **Q: How much resources does this use?**

A: With all stacks running, expect to use 8-16GB RAM and 4-8 CPU cores under normal load. Individual stacks use much less.



### **Q: Is this suitable for production?**

A: Currently in alpha. We recommend testing thoroughly before production use. Beta release planned for Q2 2025.



### **Q: How do I backup my data?**

A: All container data is stored in `/opt/awesome-stack/`. Regular backups of this directory will preserve all configurations and data.



---



## 📞 **Support**



- 🐛 **Issues**: [GitHub Issues](https://github.com/wlfogle/blendos-awesome-stack/issues)

- 💬 **Discussions**: [GitHub Discussions](https://github.com/wlfogle/blendos-awesome-stack/discussions)

- 📧 **Email**: [Contact Form](https://github.com/wlfogle/blendos-awesome-stack#contact)

- 💬 **Matrix**: Coming soon!



---



## 📄 **License**



This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.



---



## 🙏 **Acknowledgments**



- **[blendOS Team](https://blendos.co/)**: For creating an excellent immutable distribution

- **[Podman Project](https://podman.io/)**: For containerization without daemon

- **Community Contributors**: Everyone who helps test and improve this project



---






**⭐ Star this repository if it helped you! ⭐**



*Built with ❤️ for the blendOS community*