Skip to content

Manual Installation

For advanced users who want full control over the installation.

Prerequisites

  • Java 17+ (OpenJDK)
  • Node.js 18+
  • PostgreSQL 14+
  • Redis 7+

Step 1: Clone Repository

bash
git clone https://github.com/ops-atlas/ops-atlas.git
cd ops-atlas

Step 2: Database Setup

sql
-- Create database
CREATE DATABASE opsatlas;

-- Create user
CREATE USER opsatlas WITH PASSWORD 'your-password';
GRANT ALL PRIVILEGES ON DATABASE opsatlas TO opsatlas;

Step 3: Build Backend

bash
cd backend
./mvnw clean package -DskipTests

# Or with Gradle
./gradlew build -x test

Step 4: Build Frontend

bash
cd frontend
npm install
npm run build

Step 5: Configure

Create application.yml:

yaml
spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/opsatlas
    username: opsatlas
    password: your-password
  redis:
    host: localhost
    port: 6379

jwt:
  secret: your-64-character-jwt-secret-here

server:
  port: 8080

Step 6: Run

bash
# Start backend
java -jar target/ops-atlas-*.jar

# Serve frontend (production)
npx serve -s frontend/dist -l 3000

Systemd Service

ini
# /etc/systemd/system/ops-atlas.service
[Unit]
Description=Ops Atlas
After=network.target postgresql.service redis.service

[Service]
Type=simple
User=opsatlas
WorkingDirectory=/opt/ops-atlas
ExecStart=/usr/bin/java -jar /opt/ops-atlas/ops-atlas.jar
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
bash
sudo systemctl enable ops-atlas
sudo systemctl start ops-atlas

Released under the MIT License.