Skip to main content

Installation Guide

Complete installation guide for NopeSight platform.

System Requirements​

Minimum Requirements​

  • CPU: 4 cores
  • RAM: 8GB
  • Storage: 50GB SSD
  • OS: Ubuntu 20.04+, RHEL 8+, Windows Server 2019+
  • CPU: 8+ cores
  • RAM: 16GB+
  • Storage: 100GB+ SSD
  • OS: Ubuntu 22.04 LTS

Prerequisites​

Software Dependencies​

# Node.js 16+
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

# MongoDB 4.4+
wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
sudo apt-get update
sudo apt-get install -y mongodb-org

# Redis 6+
sudo apt-get install -y redis-server

# Python 3.8+
sudo apt-get install -y python3 python3-pip

Installation Steps​

1. Download NopeSight​

# Clone repository
git clone https://github.com/your-org/nopesight.git
cd nopesight

# Or download release
wget https://releases.nopesight.com/latest/nopesight.tar.gz
tar -xzf nopesight.tar.gz
cd nopesight

2. Backend Installation​

cd backend
npm install --production

# Configure environment
cp .env.example .env
nano .env

# Initialize database
npm run init-db

# Start service
npm start

3. Frontend Installation​

cd ../frontend
npm install

# Build for production
npm run build

# Serve with nginx or similar
sudo cp -r build/* /var/www/nopesight/

4. Discovery Agent Setup​

cd ../NopeSightAgent
pip3 install -r requirements.txt

# Configure agent
cp config.example.json config.json
nano config.json

# Test connection
python3 agent.py --test

Configuration​

Environment Variables​

# Database
MONGODB_URI=mongodb://localhost:27017/nopesight
REDIS_URL=redis://localhost:6379

# Security
JWT_SECRET=your-secret-key
API_KEY=your-api-key

# AI Services
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret

Service Configuration​

# Create systemd service
sudo nano /etc/systemd/system/nopesight.service

[Unit]
Description=NopeSight Backend
After=network.target

[Service]
Type=simple
User=nopesight
WorkingDirectory=/opt/nopesight/backend
ExecStart=/usr/bin/node server.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

# Enable service
sudo systemctl enable nopesight
sudo systemctl start nopesight

Post-Installation​

1. Verify Installation​

# Check services
systemctl status nopesight
systemctl status mongodb
systemctl status redis

# Test API
curl http://localhost:5000/api/health

2. Initial Setup​

  • Access web interface
  • Create admin account
  • Configure departments
  • Set up discovery

3. Security Hardening​

  • Change default passwords
  • Configure firewall
  • Enable SSL/TLS
  • Set up backups

Troubleshooting​

Common Issues​

  • Port conflicts
  • Permission errors
  • Database connection
  • Missing dependencies

Getting Help​