🚀 WAGMI: Self-Hosted Container Management with AI

---

👷‍♂️ Building

🌐 os.wagmilabs.fun
🌐 wagmilabs.fun

---

📌 Table of Contents

• 📚 Introduction
• ✨ Features
• 💬 W.I.L.L.O.W
• ⚡ Installation
• 🐧 Examples
• 💾 Tested Systems
• 🔜 Upcoming Features
• 🔒 Security

---

📚 Introduction

WAGMIOS is a self-hosted container management system with AI-powered automation.
It enables you to efficiently manage your containers with W.I.L.L.O.W, an AI assistant that optimizes your workflow.

---

✨ Features

• ✅ Fully Self-Hosted – Manage everything on your own infrastructure
• ✅ Customizable Homepage – Bookmark your favorite sites
• ✅ Docker Marketplace & UI – Easily browse, install, and manage containers
• ✅ AI-Powered Management – Seamless integration with W.I.L.L.O.W
• ✅ Supports Home Assistant & Jenkins – More integrations coming soon!

---

💬 W.I.L.L.O.W

W.I.L.L.O.W (Workflow Intelligent Localized Learning & Optimized Worker) is an AI-powered agent designed to streamline container management.
She acts as an oracle, guiding you through container setup and integrations.

🔗 Learn more: Read the full article

---

⚡ Installation

1️⃣ Ensure Docker is Installed

• Get the latest version here: Docker Installation Guide

2️⃣ Clone the Repository

git clone https://github.com/mentholmike/wagmios.git

3️⃣ Navigate to the Project Directory

cd wagmios

4️⃣ Run Docker Compose

sudo docker compose up -d

👷‍♂️ Alternative Build Using Docker Hub

Prefer using Docker Hub?

1️⃣ Pull the Image

docker pull itzmizzle/wagmi:latest

2️⃣ Create the Yaml File

version: '3.8'

services:
  frontend:
    image: itzmizzle/wagmi:frontend-latest
    container_name: wagmios-frontend
    ports:
      - "5174:5174"
    depends_on:
      - backend
    environment:
      - VITE_API_URL=http://localhost:8080
    networks:
      - wagmios-network
    restart: unless-stopped
    volumes:
      - frontend_data:/app/data

  backend:
    image: itzmizzle/wagmi:backend-latest
    container_name: wagmios-backend
    ports:
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - backend_data:/app/data
    environment:
      - PORT=8080
      - WILLOW_URL=http://willow:5678
    networks:
      - wagmios-network

  willow:
    image: n8nio/n8n
    container_name: willow
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_SECURE_COOKIE=false
      - N8N_DEFAULT_WORKFLOW_STATE=active
      - N8N_LOG_LEVEL=info
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=willow_memories
      - DB_POSTGRESDB_USER=willow
      - DB_POSTGRESDB_PASSWORD=wagmios
    volumes:
      - willow_data:/home/node/.n8n
    depends_on:
      - postgres
    networks:
      - wagmios-network

  postgres:
    image: postgres:latest
    container_name: postgres
    restart: always
    ports:
      - "5443:5432"
    environment:
      - POSTGRES_USER=willow
      - POSTGRES_PASSWORD=wagmios
      - POSTGRES_DB=willow_memories
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - wagmios-network

networks:
  wagmios-network:
    driver: bridge

volumes:
  willow_data:
  postgres_data:
  frontend_data:
  backend_data:

3️⃣ Run Docker Compose

sudo docker compose up -d

---

🐧 Examples

---

💾 Tested Systems

✅ Ubuntu (multiple versions)
✅ Debian (Bookworm) – Works on Raspberry Pi
✅ LXC Containers – Requires root privileges for Gluetun
✅ Mac & WSL for Linux – Known issue: overestimates disk storage

---

🔜 Upcoming Features

• Deeper integration with W.I.L.L.O.W
• Expanded AI automation for container management
• New integrations for Kubernetes & cloud services

---

🔒 Security

⚠️ This project is still in active development. It is currently intended for private/home usage.
⚠️ If deploying on a VPS, be cautious of exposing your IP!

---