Skip to main content
This covers port conflict issues and how to resolve them.

Development Server Port Conflict

Symptoms

Cause

Another process is already running on the specified port.

Solutions

1. Find and Kill Process

macOS/Linux:
Windows:

2. Manually Specify Port

sonamu.config.ts:

Sonamu UI Access

Description

Sonamu UI uses the same port as the API server and is accessed via the /sonamu-ui path.
Sonamu UI access: http://localhost:10280/sonamu-ui

Running Multiple Projects Simultaneously

Symptoms

Ports conflict when trying to run multiple Sonamu projects simultaneously.

Solution

Use different ports for each project: Project A:
Project B:

PostgreSQL Port Conflict

Symptoms

Cause

PostgreSQL is not running, or another process is using port 5432.

Solutions

1. Check PostgreSQL Running

2. Run PostgreSQL on Different Port

In PostgreSQL config file (postgresql.conf):
After restart, update .env file:

3. Check Port Conflict Process