Skip to main content

Manual Installation

Set up Hive-Pal without Docker for more control over the environment.

Prerequisites​

System Dependencies​

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm postgresql postgresql-contrib git

# macOS
brew install node postgresql git

# Windows
# Use official installers for Node.js, PostgreSQL

Node.js Setup​

# Install pnpm
npm install -g pnpm

# Verify versions
node --version  # Should be 18+
pnpm --version

Database Setup​

PostgreSQL Installation​

-- Create database and user
CREATE DATABASE hivepal;
CREATE USER hivepal_user WITH PASSWORD 'secure_password';
GRANT ALL PRIVILEGES ON DATABASE hivepal TO hivepal_user;

Configuration​

# Edit postgresql.conf
listen_addresses = 'localhost'
port = 5432

# Edit pg_hba.conf
local   hivepal    hivepal_user                     md5
host    hivepal    hivepal_user    127.0.0.1/32     md5

Application Setup​

Clone Repository​

git clone https://github.com/martinhrvn/hive-pal.git
cd hive-pal

Install Dependencies​

# Install all packages
pnpm install

# Verify workspace structure
pnpm list --depth=0

Environment Configuration​

# Backend environment
cd apps/backend
cp .env.example .env

# Frontend environment  
cd ../frontend
cp .env.example .env

Database Migration​

# From backend directory
pnpm prisma generate
pnpm prisma migrate dev
pnpm seed  # Optional test data

Development Setup​

Start Services​

# Terminal 1: Backend
cd apps/backend
pnpm dev

# Terminal 2: Frontend
cd apps/frontend  
pnpm dev

# Terminal 3: Database (if needed)
sudo service postgresql start

Verify Installation​

Production Setup​

Build Applications​

# Build all packages
pnpm build

# Production dependencies only
pnpm install --prod

Process Manager​

# Install PM2
npm install -g pm2

# Create ecosystem file
# ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'hive-pal-backend',
      script: './apps/backend/dist/main.js',
      env: {
        NODE_ENV: 'production'
      }
    }
  ]
}

# Start with PM2
pm2 start ecosystem.config.js

Web Server Setup​

# nginx configuration
server {
    listen 80;
    server_name your-domain.com;
    
    location /api {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
    }
    
    location / {
        root /path/to/frontend/dist;
        try_files $uri $uri/ /index.html;
    }
}

Security​

SSL Certificate​

# Using Certbot
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

Firewall​

# UFW rules
sudo ufw allow 22    # SSH
sudo ufw allow 80    # HTTP
sudo ufw allow 443   # HTTPS
sudo ufw enable

Monitoring​

System Monitoring​

# Install monitoring tools
npm install -g htop iotop

# Check processes
pm2 status
pm2 logs

Database Monitoring​

-- Check connections
SELECT * FROM pg_stat_activity;

-- Monitor performance
SELECT * FROM pg_stat_database;

Backup​

Automated Backups​

#!/bin/bash
# backup.sh
DATE=$(date +%Y%m%d_%H%M%S)
pg_dump -U hivepal_user hivepal > backups/hivepal_$DATE.sql
tar -czf backups/uploads_$DATE.tar.gz uploads/

# Add to crontab
0 2 * * * /path/to/backup.sh

Updates​

Application Updates​

# Pull changes
git pull origin main

# Update dependencies
pnpm install

# Run migrations
cd apps/backend
pnpm prisma migrate deploy

# Rebuild
pnpm build

# Restart services
pm2 restart all

Troubleshooting​

Common Issues​

  • Port already in use: Check with netstat -tlnp
  • Database connection: Verify credentials and service
  • Permission errors: Check file ownership
  • Memory issues: Monitor with htop

Log Locations​

  • Application logs: ~/.pm2/logs/
  • System logs: /var/log/
  • Database logs: /var/log/postgresql/