Skip to main content
ShipSec Studio uses just as its command runner. Run just or just help to see all available commands.

Getting Started

Initialize Project

Sets up the development environment:
  • Installs dependencies with Bun
  • Creates environment files from examples (backend/.env, worker/.env, frontend/.env)

Development Commands

Start Development Environment

Starts the full development environment with hot-reload:
  • Checks for environment files
  • Starts Docker infrastructure (Postgres, Temporal, MinIO, Loki)
  • Waits for services to be ready
  • Runs database migrations
  • Starts backend, worker, and frontend via PM2
Access points (all via nginx on port 80):

Stop Development

Stops all PM2 processes and Docker infrastructure.

View Logs

Streams logs from all application processes via PM2.

Check Status

Shows status of PM2 processes and Docker containers.

Production Commands

Start Production

Starts the production environment using Docker Compose with pre-built images. Access points (all via nginx on port 80):

Build and Start

Builds Docker images and starts the production environment.

Stop Production

Stops all production containers.

View Production Logs

Streams logs from all production containers.

Check Production Status

Shows status of production containers.

Clean Production

This deletes all data.
Stops containers, removes volumes, and prunes Docker system.

Infrastructure Commands

Start Infrastructure

Starts only the infrastructure containers:
  • PostgreSQL
  • Temporal
  • MinIO
  • Redis
  • Loki

Stop Infrastructure

Stops all infrastructure containers.

View Infrastructure Logs

Streams logs from infrastructure containers.

Clean Infrastructure

Stops infrastructure and removes all volumes.
This deletes all data.

Utility Commands

Show All Status

Comprehensive status check showing:
  • PM2 services
  • Infrastructure containers
  • Production containers

Reset Database

Drops and recreates the database, then runs migrations. This deletes all data.
This command requires PostgreSQL to be running (just dev or just infra up).

Build Images Only

Builds production Docker images without starting containers.

Quick Reference


Environment Files

The just init command creates these environment files: Each file is created from its corresponding .env.example template.