Dashboard

--
🟢
-
Containers Running
🔴
-
Containers Stopped
⚡
-
CPU Usage
🧠
-
RAM Usage
💽
-
Disk Usage

🎮 Quick Actions

🖥️ Server Status

⏱️ Server Uptime -
🧠 RAM (Used/Total) -
💽 Disk (Used/Total) -
⚙️ .env Config -

🐳 Docker Containers

Loading containers...

🔐 Auth Proxy (Xilriws)

Loading auth proxy stats...

⚡ System Resources

💾 -- 🧠 --
💾 Disk --%
-- / -- (-- free)

🔌 System Services

Loading...
Checking system services...

🌐 Site Availability

Checking site availability...

🤖 AI Debug Panel

v-- --
⏱️ Uptime: -- PID: --
📜 Live Debug Log
Loading debug logs...

🩺 Docker Health Monitor

🐳
Docker Daemon
Checking...
📦
Docker Compose
Checking...
🌐
Docker Networks
Checking...
💾
Docker Volumes
Checking...

🔌 Container Port Accessibility

💡 Checks if each container's internal port is accessible. Green = healthy, Red = unreachable.
Click "Check Ports" to scan container accessibility
🏠 Docker Root: --
📊 Docker Version: --
🖥️ Compose File: --
📈 Total Images: --
💿 Docker Disk Usage: --

🔧 Docker Installation & Service

💡 Install or update Docker components. Requires sudo access on the server.
🐳
Docker Engine
Container runtime & CLI
Checking...
📦
Docker Compose
Multi-container orchestration
Checking...
🔨
Docker Buildx
Extended build capabilities
Checking...
🚀
Full Docker Setup
Install all components + configure
🔍
Check Duplicate Docker
Detect conflicting Snap vs Apt installs
Not checked

📁 Docker Configuration Files

⚠️ Edit Docker service configuration. Changes require Docker service restart to take effect.
⚙️
daemon.json
/etc/docker/daemon.json
Docker daemon configuration (logging, storage, registry mirrors)
--
🔧
docker.service
/etc/systemd/system/docker.service.d/override.conf
Systemd service overrides (environment, limits)
--
📝
docker-compose.override.yml
Local compose overrides
Override container settings without modifying main file
--
🔑
.env (Docker)
Docker Compose environment variables
Environment variables for compose services
--
🏛️
registries.conf
/etc/containers/registries.conf
Container registry configuration
--
📋
docker-logrotate
/etc/logrotate.d/docker
Docker log rotation settings
--

🐳 Docker Containers

Loading containers...
🐚
-
Config Loaded
📦
-
Components Enabled
🐳
-
Local (Docker)
🌐
-
Remote

🔧 Stack Components

Configure stack components for local Docker containers or remote services. This allows Shellder to manage distributed and hybrid deployments.

Loading configuration...

📂 General Paths

Loading...

🔒 Remote Access

Loading...

🛠️ Developer Mode

Disabled
⚠️
SECURITY WARNING

Enabling Developer Mode allows external systems to read/write files, execute commands, and access databases on this machine through the REST API and MCP server.

Only enable this if:

  • You trust the connecting AI system (like Cursor, Claude, or similar)
  • You have been instructed to do so by a Pokemod or Unown# developer for debugging
  • You understand that this gives complete control over your Aegis AIO stack

When disabled, all API endpoints return "403 Forbidden" and external access is blocked. The toggle state does not persist across restarts (defaults to OFF).

🌐 Network Requirements: For external AI access, ensure port 5000 is open in your firewall and forwarded through your router if behind NAT.

Developer Mode: Secured
API Endpoint: Loading...
External Access: Disabled

📄 Configuration File

Shellder/shellder_config.toml

⚙️
Checking...
Setup Status
📄
-/-
Config Files
⚙️
-/-
Config Variables ▼
Config Variables Status
Loading...
📦
-
Repository

📦 Repository Status

Loading...

⚡ Quick Actions

📜 Recent Commits

Loading...

📄 Configuration Files

Loading...

⚙️ Config Variables Status

📊 - Total
✅ - Configured
⚠️ - Missing
🔗 - Synced
❌ - Mismatched
Configured & Synced Values Mismatch Still Default 🔗 = Shared across configs
Loading configuration status...
🧙‍♂️

Stack Setup Wizard

This wizard will guide you through setting up your Aegis AIO stack step by step.

  • ✅ Check Docker & Docker Compose
  • ✅ Verify port availability
  • ✅ Detect system resources
  • ✅ Configure files and passwords
  • ✅ Optimize database settings
  • ✅ Start the stack

Shellder Scripts

Run scripts via terminal for full interactivity

🚀
Initial Setup
First-time configuration
🗄️
Database Manager
MariaDB setup & maintenance
🔒
Security Setup
Nginx & SSL configuration
✅
System Check
Verify configuration
📋
Log Manager
View Docker logs
📁
File Manager
Git & file operations
🔔
Poracle Setup
Notification system
🐦
Fletchling Setup
Quest scanning
💡
To run scripts with full interactivity: sudo bash shellder.sh

🪺 Fletchling - Nest Detection

Fletchling detects Pokemon nests in parks and displays them on ReactMap. This is an optional feature that requires Koji geofences.

Docker Compose
Service enabled in docker-compose.yaml
Configuration
fletchling.toml configured with Koji project
Container Running
Fletchling container status
Nests Table
Nests data in golbat database
OSM Park Data
OpenStreetMap park polygons imported
Golbat Webhook
Pokemon data flowing to Fletchling

🔧 Setup Steps

1
Enable Fletchling Service
Uncomment Fletchling in docker-compose.yaml
2
Configure Koji Project
Set your Koji project name in fletchling.toml
💡 This must match the project name you created in Koji Admin exactly
3
Start Fletchling Containers
Start containers first (required for OSM import)
4
Import OSM Park Data
Import park/nature area data from OpenStreetMap (where nests spawn)
💡 This imports park boundaries from OpenStreetMap. The area name must exactly match one of your Koji geofence names. This may take several minutes.
5
Configure Golbat Webhook
Add webhook to send Pokemon data to Fletchling
6
Restart Golbat
Apply webhook changes by restarting Golbat

🗺️ Nest Management

🏞️
-
Monitored Areas
🪹
-
Total Nests
✅
-
Active Nests
❓
-
Unknown Names
Name Area Pokemon Spawns Last Updated Actions
Loading nests...
Page 1 of 1

📍 Monitored Areas

Areas imported from Koji for OSM park data. Each area can have multiple nests.

Loading areas...

📚 Documentation

📖 Fletchling Docs 🐙 GitHub Repository 📋 Aegis AIO Wiki

🔔 Poracle - Discord & Telegram Alerts

Poracle sends customizable notifications to Discord or Telegram when Pokemon spawn, raids start, quests appear, or Team Rocket invades. Users can set up their own filters via bot commands. This is an optional feature.

Docker Compose
Service enabled in docker-compose.yaml
Configuration
Poracle/config/local.json configured
Container Running
Poracle container status
Database
Poracle database tables exist
Discord Bot
Discord integration status
Telegram Bot
Telegram integration status
Golbat Webhook
Receiving data from Golbat

🔧 Setup Steps

1
Enable Poracle Service
Uncomment Poracle in docker-compose.yaml
2
Configure Database Connection
Database settings auto-configured from .env
3
Configure Discord Bot (Optional)
Set up Discord bot for notifications
💡 Get bot token from Discord Developer Portal. Get your User ID by enabling Developer Mode in Discord settings, then right-click your name.
4
Configure Telegram Bot (Optional)
Set up Telegram bot for notifications
💡 Create bot via @BotFather on Telegram. Get your User ID from @userinfobot.
5
Configure Golbat Webhook
Add webhook to send Pokemon/raid/quest data to Poracle
6
Import Geofences from Koji
Import area definitions for location-based alerts
💡 Geofences define areas where users can receive alerts (e.g., "Downtown", "North Side")
7
Start Poracle
Start the Poracle container

📜 Recent Logs

Logs will appear when Poracle is running...

📚 Documentation

📖 Poracle Wiki 🐙 GitHub Repository 💬 Discord Setup Guide 📱 Telegram Setup Guide 📋 Aegis AIO Wiki

📊 All Stack Logs

0 lines - 
Loading logs...

🔌 Connection Status

JavaScript: checking...
API Connection: checking...
WebSocket: checking...
Client Logs: 0

💻 Client-Side Logs

Browser-side logs captured by the GUI. Useful for debugging UI issues.

Loading client logs...

🖥️ Server Debug Log (debuglog.txt)

Combined server + client logs in Shellder/debuglog.txt. Auto-synced every 30 seconds. For AI debugging, share this file.

Lines: - Size: - 
Loading server logs...

📡 Live Debug Streams

Stream live debug logs directly to your AI assistant via terminal. Use these endpoints to provide real-time context.

🖥️
Browser Live Stream View live logs directly in this page
Stopped
💻
Terminal Commands Run these in terminal for AI debugging
Plain Text: curl -N http://localhost:5050/api/debug/tail
JSON Events: curl -N http://localhost:5050/api/debug/stream
File Tail: tail -f ~/Desktop/Aegis-All-In-One/Shellder/logs/debuglog.txt

🤖 AI Debug Access

Enable programmatic access for AI assistants to debug your system. All access methods work on port 5050.

🔌 Access Methods

🔐 Permissions

📋 Instructions for Your AI Assistant

Copy and paste these instructions to your AI (ChatGPT, Claude, etc.): 

Loading...

🧪 Quick Test

Test the AI debug API:

curl http://localhost:5050/api/ai-debug/help
curl http://localhost:5050/api/ai-debug/diagnose

🤖 AI Integration (Terminal Commands)

Your AI assistant can access Shellder's debug API using terminal commands. Copy the instructions below and paste them to your AI.

Checking...

⚡ Quick Setup - Copy & Paste to AI

Copy this entire block and paste it to your AI assistant (Claude, ChatGPT, etc.): 

Loading API instructions...

🌐 Network Requirements for External AI Access

For AI tools (like Cursor) on another machine to connect:

  • Firewall: Open port 5000 (e.g., sudo ufw allow 5000)
  • Router: Forward port 5000 to this machine's local IP if behind NAT
  • Alternative: Use SSH tunnel: ssh -L 5000:localhost:5000 user@your-server-ip

Your detected URL: detecting...

🛠️ Available MCP Tools

shellder_diagnose Full system diagnostics
shellder_read_file Read any file in Aegis
shellder_write_file Write/modify files
shellder_exec Run shell commands
shellder_docker Docker operations
shellder_sql Database queries
shellder_logs System/container logs
shellder_system System information

🧪 Test API Connection

Test the API that MCP connects to:

📚 AI Debugging Reference

📁 Debug Log Location: Shellder/logs/debuglog.txt
🔄 Auto-Sync: Client logs sync to server every 30 seconds automatically
💻 Console Commands: SD.export() - Export all logs | SD.logs - View log array | SD.clear() - Clear client logs
📤 Share with AI: Download debuglog.txt and share it with your AI assistant for debugging help
Nginx Status: Checking...
🌐
-
Sites Enabled
📁
-
Sites Available
🔒
-
SSL Certificates
🔍
--
Sites Healthy

🚀 Initial Security Setup

First-time configuration for nginx, SSL, and security services
1 ⏳
Nginx Web Server
Reverse proxy for all services
2 ⏳
Configure Sites
Set up reverse proxy for ReactMap, Koji, etc.
3 ⏳
Certbot (Let's Encrypt)
SSL certificates (requires sites configured first)
4 ⏳
Fail2Ban
Brute-force and bot protection
5 ⏳
Authentication
Protect sites with login (optional)
6 ⏳
UFW Firewall
Network traffic filtering

✅ Sites Enabled

sites-enabled
Loading sites...

📁 Sites Available

sites-available (disabled)
Loading sites...

📝 Site Configuration

🚀 Quick Nginx Setup

Setup Nginx and SSL for all running stack containers

Step 1: Base Configuration

Add one or more domains. Each service can use any of these domains.
Choose how services are accessed by default
Required for Let's Encrypt SSL certificates

Step 2: Configure Services

Select services to configure. Customize domains, structure, and ports for each:

⚠️ Note: Rotom requires WebSocket support and special configuration - use the dedicated Rotom setup instead.
Loading running containers...

📋 Nginx Error Log

Loading nginx logs...

🛡️ Security Services

Firewall, intrusion prevention, and authentication controls

🔥
-
UFW Firewall
🚫
-
Fail2Ban
🔑
-
Authelia SSO
👤
-
Basic Auth Users

🔥 UFW Firewall

Loading firewall rules...

Add Rule

🚫 Fail2Ban

Loading fail2ban status...

Unban IP

🔑 Authelia SSO

Loading Authelia status...
🌐 Open Authelia Portal

👤 Basic Auth (htpasswd)

Loading users...

Add/Update User

🔒 SSL Certificates

Loading certificates...
Connecting to stack database...
📍
-
Active Pokemon
👤
-
Active Accounts
📱
-
Online Devices
⚡
-
Pokemon/Hour

🎮 Scanner Overview

Loading scanner data...

👤 Account Health

🗺️ Map Data (Golbat)

Loading Golbat data...

📐 Geofencing (Koji)

Loading Koji data...

📱 Connected Devices

0 devices
Loading device list...
📱
-
Online
⏹️
-
Offline
💥
-
Crashes (24h)
⏱️
-
Avg Uptime

📱 Device Status

Loading devices...

💥 Recent Crashes

Loading crashes...

⚡ Live Activity

Stopped
Container Status
Loading...
Click "Start" to begin real-time monitoring
Xilriws Container: Checking...
✓
--%
Overall Success Rate
👤
--%
Account Success
🌐
--%
Proxy Success
🟢
-
Successful Auth
🔴
-
Failed
📊
-
Total Requests
🍪
-/-
Cookie Storage
⚠️
0
Critical Events

🔴 Error Breakdown

Account Status

🚫 Account Banned (418) 0
🔄 Max Retries Exceeded 0
💥 Internal Server Error 0

Browser Issues

🛡️ Bot Protection (Code 15) 0
⏱️ Page Timeout 0
🌐 Page Unreachable 0
⏳ JS Challenge Timeout 0

Connection Issues

🚇 Tunnel Failed (407) 0
⏰ Connection Timeout 0
🔐 Captcha Triggered 0

🌐 Proxy Performance

Current: --
Loading proxy stats...

⚡ Recent Errors

0 errors
No recent errors

📝 Proxy Manager

Edit proxies below (one per line). Format: host:port or user:pass@host:port

File: xilriws/proxies.txt | 0 proxies loaded

🗑️ Chrome Temp File Manager

Temp Files --
Total Size --
Auto-Cleanup --
<1 day 1-7 days 7-30 days >30 days

Auto-Cleanup Settings

Enable Auto-Cleanup
Clean when size exceeds this
Delete files older than this
How often to check

📜 Live Xilriws Logs

Connecting to Xilriws logs...

Historical Statistics

All-Time Proxy Stats

Proxy Total Success Failed Rate
Loading...

Recent System Events

Loading events...

Container Uptime History

Loading container history...
VictoriaMetrics
Grafana

Connecting to Grafana...

Dashboard loading on port 6006

🔎 Custom PromQL Query

Enter a query above and click Execute to see results

📁 File Manager

|
- | 0 items
📂
Loading files...