System Requirements
Minimum Requirements
| Component | Requirement |
|---|---|
OS | Ubuntu 20.04+ / Debian 11+ / CentOS 8+ |
CPU | 2 cores |
RAM | 4GB |
Disk | 20GB free space |
Network | Public IP address |
Ports | 80, 443 (open to internet) |
Recommended Requirements
- OS: Ubuntu 22.04 LTS
- CPU: 4+ cores
- RAM: 8GB+
- Disk: 50GB+ SSD
- Network: 100Mbps+ connection
- Ports: 80, 443, 22 (SSH)
Firewall Requirements
Ensure these ports are open:
Port 80/tcp- Open to 0.0.0.0/0 (for Let's Encrypt validation)Port 443/tcp- Open to 0.0.0.0/0 (for HTTPS web access)Port 22/tcp- Open to your IP only (recommended for SSH)
Installation Methods
Method 1: Automated Installation (Recommended)
Step 1: Prepare your server by updating system packages and installing curl if not present:
sudo apt update && sudo apt upgrade -y
sudo apt install curl -yStep 2: Run the installation script:
curl -fsSL https://install.aode.tech/install-secure.sh | sudo bash -s YOUR-LICENSE-KEYStep 3: The installer will automatically check system requirements, install Docker and Docker Compose if needed, install Node.js 20 and pnpm, and download the AODE boilerplate package.
Step 4: Follow the interactive prompts to enter your system name, main domain (the domain where your portal will be accessible), email address for SSL certificates, and admin username and password. The installer will automatically generate secure database passwords, JWT secrets, encryption keys, and session secrets.
Step 5: The installer builds the portal application, configures the firewall to allow SSH, HTTP, and HTTPS, and starts all services. Wait 5-10 minutes for installation to complete.
Note: The script does not support command-line flags for configuration. All settings are collected interactively during installation to ensure proper setup and validation.
Initial Configuration
Accessing the Portal
After installation, access your portal at https://yourdomain.com/login where yourdomain.com is the domain you configured during installation. SSL certificates are automatically issued by Let's Encrypt within a few minutes. If you see a certificate warning, wait 2-5 minutes for certificate issuance, then refresh.
First Login
Navigate to https://yourdomain.com/login and enter the admin username and password you created during installation. After first login you may be prompted to change your password. Password requirements are minimum 8 characters when strong passwords are enabled in settings.
Portal Dashboard
After logging in you'll see the dashboard at https://yourdomain.com/dashboard with system resource metrics, deployed projects overview, recent activity logs, and quick actions. Use the sidebar to navigate between Home, Projects, Services, Domains, Database, Updates, and Settings.
First Steps After Installation
1. Deploy Your First Project
Navigate to Projects and click Add Repository. Enter repository URL (GitHub, GitLab, or Bitbucket automatically detected from URL). Select branch (default is main). Choose subdomain or custom domain. For subdomain enter name like myapp to create myapp.yourdomain.com. For custom domain select from your configured domains. Click Advanced Settings to configure memory limit, start command, or add Git authentication token if using private repository. Click Create Project and monitor build progress in real-time logs. Your application will be accessible at the configured domain after deployment completes in 2-5 minutes.
2. Configure Custom Domain
Purchase a domain and add DNS A record pointing to your server IP. Wait 5-60 minutes for DNS propagation. In AODE portal navigate to Domains section and click Add Domain. Enter your custom domain, select target project, enable Traefik routing and SSL. The system automatically configures routing and requests Let's Encrypt SSL certificate. Wait 2-5 minutes for SSL issuance and your project will be accessible at your custom domain.
3. Set Up Git Authentication (for Private Repos)
For GitHub generate a Personal Access Token at github.com/settings/tokens with repo permissions. In AODE portal navigate to Settings and add your token in the Git Tokens section. When creating a project select your saved token from the dropdown or enter a custom token. For GitLab, Bitbucket, or self-hosted Git add tokens with the appropriate provider and URL configuration.