Prerequisites & System Requirements

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

Installation Paths

ANTE ERP offers two installation paths with different prerequisites:

Path 1: CLI Installation (Recommended) ⭐

Requirements:

• Node.js 24.0 or higher (LTS)
• npm (included with Node.js)
• Docker 20.10+
• Docker Compose v2.0+

Best for: All users, fastest installation, automated management

Path 2: Manual Docker Installation

Requirements:

• Docker 20.10+
• Docker Compose v2.0+
• Text editor (nano, vim, etc.)

Best for: Advanced users, custom configurations

---

Hardware Requirements

Minimum Specifications

Suitable for testing and small deployments (5-10 users):

• CPU: 1 core (2.0 GHz or higher)
• RAM: 2 GB
• Storage: 20 GB available disk space
• Network: 10 Mbps internet connection

Recommended Specifications

For production environments (10-50 users):

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

Enterprise Specifications

For large deployments (50+ users):

• CPU: 4+ cores (3.0 GHz or higher)
• RAM: 8 GB or more
• Storage: 100+ GB SSD
• Network: 1 Gbps connection
• Backup Storage: Additional storage for backups

Operating System

Supported Operating Systems

ANTE ERP runs on any system that supports Docker:

Linux (Recommended)

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

macOS

• macOS: 11 (Big Sur) or later
• Suitable for development/testing only

Windows

• Windows: 10 Pro/Enterprise or Windows Server 2019+
• Requires WSL2 (Windows Subsystem for Linux 2)
• Suitable for development/testing only

Production Recommendation

For production deployments, we strongly recommend Ubuntu 22.04 LTS or Debian 12 for stability and long-term support.

Required Software

1. Node.js (For CLI Installation Only)

Required for: CLI installation path only Version: 24.0 or higher (LTS) Skip if: Using manual Docker installation

Installation on Ubuntu/Debian

# Install Node.js 24.x LTS (via NodeSource)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# Verify installation
node --version   # Should show v24.x.x or higher
npm --version    # Should show 10.x.x or higher

Node.js 24 LTS (October 2025)

NodeSource provides officially maintained Node.js packages for production use. Node.js 24 is the latest LTS version (as of October 2025), supported until April 2028. This is the recommended version for production deployments.

Installation on CentOS/RHEL/Rocky

# Install Node.js 24.x LTS
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo yum install -y nodejs

# Verify
node --version
npm --version

Installation on macOS

# Using Homebrew
brew install node@24

# Verify installation
node --version
npm --version

Development Only

macOS installation is suitable for development and testing only. For production deployments, use Ubuntu/Debian Linux.

Verify Node.js Installation

# Check Node.js version (should be 24.x or higher)
node --version

# Check npm version
npm --version

# Test npm works
npm --help

Once Node.js is installed, you can install the ANTE CLI:

# Install ANTE CLI globally
npm install -g ante-erp-cli

# Verify CLI installation
ante --version

2. Docker Engine

ANTE ERP requires Docker Engine 20.10.0 or later.

Installation on Ubuntu/Debian

# Update package index
sudo apt-get update

# Install prerequisites
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Add Docker's official GPG key
sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Set up repository
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker Engine
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Verify installation
docker --version

Installation on CentOS/RHEL/Rocky

# Install prerequisites
sudo yum install -y yum-utils

# Add Docker repository
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# Install Docker
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Start Docker
sudo systemctl start docker
sudo systemctl enable docker

# Verify installation
docker --version

Post-Installation Steps

# Add your user to docker group (optional, avoids using sudo)
sudo usermod -aG docker $USER

# Log out and log back in for group changes to take effect
# Or run: newgrp docker

# Verify Docker works without sudo
docker run hello-world

3. Docker Compose

Docker Compose V2 (included with modern Docker installations) is required.

Verify Installation

# Check Docker Compose version
docker compose version

# Should show: Docker Compose version v2.x.x or later

If Not Installed (Manual Installation)

# Download Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# Make executable
sudo chmod +x /usr/local/bin/docker-compose

# Verify
docker-compose --version

4. Git (Optional but Recommended)

# Ubuntu/Debian
sudo apt-get install -y git

# CentOS/RHEL
sudo yum install -y git

# Verify
git --version

5. Text Editor

You'll need a text editor to modify configuration files:

• nano (beginner-friendly, pre-installed on most systems)
• vim or vi (advanced)
• Visual Studio Code with Remote SSH (for remote servers)

Network Requirements

Required Ports

The following ports must be available on your server:

Port	Service	Required	Purpose
8080	Frontend	✅ Yes	Web interface access
3001	Backend API	✅ Yes	API endpoints
4001	WebSocket	✅ Yes	Real-time updates
5433	PostgreSQL	🔒 Internal	Database (can be internal only)
6380	Redis	🔒 Internal	Cache (can be internal only)
27018	MongoDB	🔒 Internal	Documents (can be internal only)
80	HTTP	📋 Optional	HTTP redirect to HTTPS
443	HTTPS	📋 Optional	Secure web access

Port Configuration

Only ports 8080, 3001, and 4001 need to be accessible from the network. Database ports can remain internal to the Docker network for security.

Firewall Configuration

# Ubuntu/Debian (using ufw)
sudo ufw allow 8080/tcp   # Frontend
sudo ufw allow 3001/tcp   # Backend API
sudo ufw allow 4001/tcp   # WebSocket
sudo ufw allow 80/tcp     # HTTP (optional, for SSL redirect)
sudo ufw allow 443/tcp    # HTTPS (optional)
sudo ufw enable

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

Domain Name (Optional but Recommended)

For production deployments with SSL:

• A registered domain name (e.g., erp.yourcompany.com)
• DNS A record pointing to your server's IP address
• Ability to configure SSL certificates (Let's Encrypt recommended)

Internet Access

During Installation

• Required to download Docker images (~2-3 GB total)
• Images are pulled from GitHub Container Registry (ghcr.io)

During Operation

• Optional for ongoing operation (system can run air-gapped)
• Required only for:
  • Pulling updates
  • Email notifications (if configured)
  • External integrations (if used)

Verification Checklist

Run these commands to verify your system is ready:

For CLI Installation Path

# 1. Check Node.js version (should be 24.0+)
node --version

# 2. Check npm version
npm --version

# 3. Verify ANTE CLI can be installed
npm install -g ante-erp-cli
ante --version

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

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

# 6. Verify Docker is running
docker ps

# 7. Check available disk space (should have 20GB+)
df -h

# 8. Check available memory (should have 4GB+)
free -h

# 9. Check CPU cores (should have 2+)
nproc

# 10. Test Docker works
docker run hello-world

# 11. Check ports are available
sudo netstat -tuln | grep -E ':(8080|3001|4001|5433|6380|27018)'
# Should return empty (ports available)

For Manual Docker Installation Path

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

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

# 3. Verify Docker is running
docker ps

# 4. Check available disk space (should have 20GB+)
df -h

# 5. Check available memory (should have 4GB+)
free -h

# 6. Check CPU cores (should have 2+)
nproc

# 7. Test Docker works
docker run hello-world

# 8. Check ports are available
sudo netstat -tuln | grep -E ':(8080|3001|4001|5433|6380|27018)'
# Should return empty (ports available)

Expected Output Examples

For CLI Installation Path

$ node --version
v24.0.0

$ npm --version
10.9.0

$ ante --version
ante-erp-cli/1.0.0

$ docker --version
Docker version 24.0.7, build afdd53b

$ docker compose version
Docker Compose version v2.23.0

$ free -h
              total        used        free      shared  buff/cache   available
Mem:           7.7Gi       2.1Gi       3.2Gi       234Mi       2.4Gi       5.1Gi
Swap:          2.0Gi          0B       2.0Gi

$ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1        50G   15G   33G  32% /

For Manual Docker Installation Path

$ docker --version
Docker version 24.0.7, build afdd53b

$ docker compose version
Docker Compose version v2.23.0

$ free -h
              total        used        free      shared  buff/cache   available
Mem:           7.7Gi       2.1Gi       3.2Gi       234Mi       2.4Gi       5.1Gi
Swap:          2.0Gi          0B       2.0Gi

$ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1        50G   15G   33G  32% /

Additional Recommendations

For Production Deployments

1. Monitoring Tools

   • Install monitoring (Prometheus, Grafana, or similar)
   • Set up disk space alerts
   • Configure log rotation

2. Backup Solution

   • External backup storage
   • Automated backup scripts
   • Tested restore procedures

3. Security

   • Keep system packages updated
   • Configure automatic security updates
   • Use strong passwords
   • Enable firewall
   • Consider VPN for admin access

4. Performance

   • SSD storage recommended
   • Consider dedicated database server for large deployments
   • Enable swap space if RAM is limited

Common Issues

Issue: Docker permission denied

# Error: permission denied while trying to connect to the Docker daemon socket
# Solution: Add user to docker group
sudo usermod -aG docker $USER
newgrp docker

Issue: Port already in use

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

# Kill process if necessary
sudo kill -9 <PID>

# Or change port in docker-compose.yml

Issue: Insufficient disk space

# Check Docker disk usage
docker system df

# Clean up unused images and containers
docker system prune -a

Next Steps

Once your system meets all requirements:

✅ System verified and ready

👉 Quick Install Guide - Start installation
👉 Detailed Installation - Step-by-step guide

---

Last Updated: October 27, 2025