Installation & Setup Guide

This guide covers the complete installation and setup process for the HostingCo system.

Prerequisites

System Requirements (Verified)

Operating System: Linux (Ubuntu 20.04+), macOS, or Windows with WSL2
Node.js: Version 18.0.0 or higher (verified: v20.19.2)
npm: Version 8.0.0 or higher (verified: v9.2.0)
Git: For version control

Optional Requirements

PostgreSQL: Version 15 or higher (optional for development)
Redis: Version 7 or higher (optional for development)
Docker: Version 20.10.0 or higher (for containerized deployment)
Docker Compose: Version 2.0.0 or higher
Nginx: For reverse proxy (production)

Installation Methods

Method 1: Manual Installation (Verified)

Step 1: Clone the Repository

git clone https://github.com/your-org/hostingco-system.git
cd hostingco-system

Step 2: Install Dependencies

# Install all dependencies for all packages
npm run install:all

# This installs dependencies for:
# - Root package (concurrently, etc.)
# - Backend package
# - Frontend package  
# - Shared package

Step 3: Environment Configuration

# Copy environment template
cp .env.example .env

# Edit environment variables as needed
nano .env

Tip: Make sure to configure database connection strings, JWT secrets, and other critical environment variables.

Verification

After installation, verify everything is working correctly:

# Check if all packages are installed
npm run check:install

# Run tests to verify functionality
npm test

# Start the development server
npm run dev