​

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 4000)

• Service: Mintlify documentation server
• URL: http://localhost:4000
• 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 Allocation Guidelines

​

Standard Port Ranges

• 3000-3999: Frontend applications and dev servers
• 4000-4999: Documentation and tooling
• 5000-5999: Database tools and admin interfaces
• 7000-7999: Backend services and APIs
• 8000-8999: Monitoring and UI tools

​

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