Skip to main content

How to set up local development

Get the Aucert monorepo running locally from scratch.

Prerequisites​

  • macOS or Linux
  • Git configured with SSH key for GitHub
  • Homebrew (macOS) or equivalent package manager

Steps​

Step 1: Install required tools​

# Node.js and pnpm
brew install node
npm install -g pnpm

# JDK 21 (Temurin)
brew install --cask temurin

# Python 3.12+
brew install python@3.12

# Infrastructure tools
brew install kubectl terraform azure-cli

Verify: node --version (22+), pnpm --version (9+), java --version (21+), python3 --version (3.12+).

Step 2: Clone the repository​

git clone git@github.com:aucert/aucert.git
cd aucert

Step 3: Install dependencies​

pnpm install

Verify: command completes without errors.

Step 4: Authenticate with Azure​

az login

Verify: az account show displays the Aucert subscription.

Step 5: Verify builds​

# Backend
cd backend/platform && ./gradlew build && cd ../..

# Frontend
cd frontend/apps/console && pnpm build && cd ../../..

# Docs
cd docs/public && pnpm build && cd ../..

Verify: all three build without errors.

Troubleshooting​

pnpm install fails with peer dependency errors — Run pnpm install --no-strict-peer-dependencies.

Gradle build fails with JDK version error — Ensure JAVA_HOME points to JDK 21: export JAVA_HOME=$(/usr/libexec/java_home -v 21).

az login hangs — Try az login --use-device-code for device code flow.

What's next​