User Guide - Introduction
What is AODE Control Portal?
AODE Control Portal is a Docker-based DevOps platform that allows you to:
- Deploy Git repositories (GitHub, GitLab, Bitbucket) as Docker containers
- Monitor system resources (CPU, Memory, Disk)
- Manage custom domains with automatic SSL certificates
- Provision PostgreSQL databases and browse them with a built-in SQL editor
- Configure email notifications and alerts via SMTP
- Monitor Docker services (Traefik, user projects)
Navigation Structure
AODE Portal navigation includes:
- Home (Dashboard): Overview of system status and statistics
- Projects: Git deployments and project management
- Services: Docker container management
- Domains: Custom domains & SSL certificate management
- Database: PostgreSQL browser & query editor
- Updates: Apply portal and host security updates
- Settings: Portal configuration. Email/SMTP setup lives here under the Notifications & Alerts tab.
Dashboard Overview
The dashboard is the main landing page after login, providing a comprehensive view of your system status, projects, resources, and activity. All metrics auto-refresh every 10 seconds.
Stats Overview Cards
- Total Projects - Shows total number of deployed projects.
- Running - Shows count of currently running projects.
- Services - Shows count of external services.
- Issues - Shows total count of system alerts and error projects. Click to open Issues Modal with detailed information.
System Resources
Three clickable resource cards that refresh every 10 seconds showing usage percentage and progress bar.
- CPU Usage - Shows CPU percentage and cores count. Click for detailed CPU metrics and process information.
- Memory - Shows memory usage percentage and used/total amounts. Click for memory breakdown and top processes.
- Disk Space - Shows disk usage percentage and used/total space. Click for disk partition details.
Last updated timestamp displayed with manual refresh button.
External Services
- Traefik - Reverse proxy and SSL management. Opens
traefik.yourdomain.comin new tab. - Docker - Container management. Links to
/dashboard/containers.
Projects Section
Shows first 3 projects with View All link. Each project displays name, status (Running or Stopped), last updated date, and View button. Shows "No recent activity" if no projects exist.
Recent Activity Feed
Scrollable feed showing last 10 project activity logs. Auto-refreshes every 10 seconds. Each entry shows colored status indicator, emoji icon, project name, activity message, and relative timestamp. Shows "No recent project activity" if empty.
Quick Actions Grid
Four action cards linking to Projects, Services, Domains, and Database sections.
Issues Modal
Opens when clicking Issues stat card.
System Alerts Section
Lists unresolved system alerts with severity badges (CRITICAL, ERROR, WARNING). Each alert shows title, message, timestamp, source, alert type, expandable technical details, and Resolve button.
Project Issues Section
Lists projects with error status. Shows project name, repository URL, error state, subdomain or port, last updated date, and View Details button.
Press Escape or click outside to close. Shows "All Systems Operational" when no issues exist.