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

PortServiceDescriptionURL
3000Next.js WebappMain frontend applicationhttp://localhost:3000
4000SSE ServerServer-Sent Events servicehttp://localhost:4000
4001Internal DocsMintlify documentation serverhttp://localhost:4001
5555Prisma StudioDatabase admin interfacehttp://localhost:5555
7233Temporal ServerTemporal workflow serverhttp://localhost:7233
8233Temporal UITemporal web interfacehttp://localhost:8233

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

Backend Services

SSE Server (Port 4000)

  • Service: Server-Sent Events service for real-time updates
  • URL: http://localhost:4000
  • Command: pnpm run dev in apps/sse-server
  • Status: Real-time communication service

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
I