Prerequisites & System Requirements

Before installing ANTE ERP, ensure your system meets these requirements.

Required Software

Node.js (CLI Installation)

• Version: 24.0 or higher (LTS)
• Includes: npm package manager
• Installation: nodejs.org/download or NodeSource

Quick Install

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# macOS
brew install node@24

Docker & Docker Compose

• Docker: Version 20.10.0 or later
• Docker Compose: V2.0 or later (included with modern Docker)
• Installation: docs.docker.com/engine/install

Docker Post-Install

Add your user to the docker group to avoid using sudo:

sudo usermod -aG docker $USER
newgrp docker

Hardware Requirements

Minimum (Testing & Small Teams: 5-10 users)

• CPU: 1 core (2.0 GHz+)
• RAM: 2 GB
• Storage: 20 GB
• Network: 10 Mbps

Recommended (Production: 10-50 users)

• CPU: 2 cores (2.5 GHz+)
• RAM: 4 GB
• Storage: 50 GB SSD
• Network: 100 Mbps

Enterprise (Large Deployments: 50+ users)

• CPU: 4+ cores (3.0 GHz+)
• RAM: 8 GB+
• Storage: 100+ GB SSD
• Network: 1 Gbps

Operating System

Supported Platforms

Linux (Recommended for Production) ✅

• Ubuntu 20.04 LTS or later (recommended: 22.04 LTS)
• Debian 11 or later
• CentOS 8+ / Rocky Linux 8+
• Fedora 35+
• RHEL 8+

macOS (Development/Testing only)

• macOS 11 (Big Sur) or later

Windows (Development/Testing only)

• Windows 10 Pro/Enterprise or Server 2019+
• Requires WSL2 (Windows Subsystem for Linux 2)

Production Environments

For production deployments, use Ubuntu 22.04 LTS or Debian 12 on Linux servers for optimal stability.

Network Requirements

Required Ports

Port	Service	Access	Purpose
8080	Frontend	Public	Web interface
3001	Backend API	Public	API endpoints
4001	WebSocket	Public	Real-time updates
5433	PostgreSQL	Internal	Database
6380	Redis	Internal	Cache
27018	MongoDB	Internal	Documents

Firewall Configuration

Only ports 8080, 3001, and 4001 need external access. Database ports should remain internal for security.

# Ubuntu/Debian (ufw)
sudo ufw allow 8080,3001,4001/tcp

# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port={8080,3001,4001}/tcp
sudo firewall-cmd --reload

Domain & SSL (Optional)

• Registered domain name (e.g., erp.yourcompany.com)
• DNS A record pointing to server IP
• SSL certificate (Let's Encrypt recommended)

Internet Access

During Installation: Required (~2-3 GB downloads from GitHub Container Registry)

During Operation: Optional (system can run air-gapped)

• Only needed for updates, email notifications, and external integrations

Quick System Check

Verify your system is ready:

# Check Node.js (should be v24.x+)
node --version

# Check Docker (should be 20.10+)
docker --version

# Check Docker Compose (should be v2.x+)
docker compose version

# Test Docker is running
docker ps

# Check system resources
df -h    # Disk space (need 20GB+)
free -h  # Memory (need 2GB+)
nproc    # CPU cores (need 1+)

Expected Output

$ node --version
v24.0.0

$ docker --version
Docker version 24.0.7, build afdd53b

$ docker compose version
Docker Compose version v2.23.0

$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

Production Best Practices

Security

• Keep system packages updated
• Enable automatic security updates
• Use strong passwords
• Configure firewall (only expose required ports)
• Consider VPN for administrative access

Monitoring & Backups

• Set up disk space monitoring and alerts
• Configure automated backup schedule
• Test backup restoration procedures
• Enable log rotation

Performance

• Use SSD storage
• Enable swap space if RAM is limited
• Consider dedicated database server for large deployments (100+ users)

Common Issues

Docker Permission Denied

# Add user to docker group
sudo usermod -aG docker $USER
newgrp docker

Port Already in Use

# Check what's using the port
sudo lsof -i :8080

# Stop conflicting service or change ANTE ports

Insufficient Disk Space

# Check Docker disk usage
docker system df

# Clean up unused resources
docker system prune -a

Next Steps

Once your system meets all requirements:

✅ System Ready

👉 Quick Install Guide - Install ANTE CLI and deploy 👉 CLI Installation - Detailed CLI setup instructions

---

Last Updated: October 27, 2025