Back to Documentation
Documentation / Getting Started / Installation Guide

Installation Guide

Complete guide to installing CognexiaAI ERP platform on your infrastructure

Last updated: January 202615 min read

Prerequisites

Before installing CognexiaAI ERP, ensure your system meets the following requirements:

Operating System: Linux (Ubuntu 20.04+, RHEL 8+, CentOS 8+) or Windows Server 2019+
Hardware: Minimum 16GB RAM, 4 CPU cores, 100GB SSD storage
Database: PostgreSQL 14+ or MySQL 8.0+
Runtime: Node.js 18+ and Python 3.10+
Network: HTTPS/SSL certificate, open ports 443, 80, 5432

Cloud Deployment (Recommended)

Deploy CognexiaAI on AWS, Azure, or Google Cloud with our automated scripts:

bash
# AWS Deployment
curl -sSL https://install.cognexiaai.com/aws | bash

# Azure Deployment  
curl -sSL https://install.cognexiaai.com/azure | bash

# Google Cloud Deployment
curl -sSL https://install.cognexiaai.com/gcp | bash

Pro Tip: Cloud deployment includes automatic scaling, backup, and monitoring setup.

Docker Installation

Quick setup using Docker Compose:

1. Clone Repository

git clone https://github.com/cognexiaai/erp-platform.git
cd erp-platform

2. Configure Environment

cp .env.example .env
# Edit .env with your configuration
nano .env

3. Start Services

docker-compose up -d

# Check status
docker-compose ps

# View logs
docker-compose logs -f

Manual Installation

Backend Setup

# Install dependencies
cd backend
npm install

# Setup database
npm run db:migrate
npm run db:seed

# Start backend server
npm run start:prod

Frontend Setup

# Install dependencies
cd frontend/auth-portal
npm install

# Build for production
npm run build

# Start production server
npm run start

Post-Installation Steps

1
Access Admin Panel: Navigate to https://your-domain.com/admin
2
Create Admin Account: Follow the setup wizard to create your first admin user
3
Configure SSL: Set up SSL certificate for secure HTTPS connections
4
Setup Backups: Configure automated backup schedule
5
Enable Monitoring: Activate system monitoring and alerts

Troubleshooting

Database connection failed

Verify database credentials in .env file and ensure PostgreSQL/MySQL service is running.

Port already in use

Change the port in configuration or stop conflicting services using: lsof -ti:3000 | xargs kill -9

Module not found errors

Delete node_modules and package-lock.json, then run npm install again.

Next Steps