Skip to main content

Port Conventions

This document outlines the standard ports used across different services and applications in the CONA project.

Active Ports Overview

Service Details

Frontend Services

Next.js Webapp (Port 3000)

  • Service: Main CONA web application
  • URL: http://localhost:3000
  • Command: pnpm run dev in apps/webapp
  • Status: Primary frontend service

Internal Documentation (Port 4001)

  • Service: Mintlify documentation server
  • URL: http://localhost:4001
  • Command: pnpm run dev in apps/internal-docs
  • Status: Development documentation

Database Services

Prisma Studio (Port 5555)

  • Service: Database administration interface
  • URL: http://localhost:5555
  • Command: pnpm run db:studio
  • Status: Database management tool

Temporal Services

Temporal Server (Port 7233)

  • Service: Temporal workflow execution engine
  • URL: localhost:7233
  • Command: temporal server start-dev
  • Status: Workflow orchestration

Temporal UI (Port 8233)

  • Service: Temporal web interface
  • URL: http://localhost:8233
  • Command: Included with Temporal server
  • Status: Workflow monitoring and debugging

Temporal Metrics (Port 51542)

  • Service: Temporal metrics endpoint
  • URL: http://localhost:51542/metrics
  • Command: Included with Temporal server
  • Status: Monitoring and observability

Port Conflict Resolution

If a port is already in use, most services will automatically try the next available port:
  • Next.js: Will try 3001, 3002, etc.
  • Mintlify: Will try 4001, 4002, etc.
  • Temporal: Has fixed port assignments