Development Server Port Conflict
Symptoms
Cause
Another process is already running on the specified port.Solutions
1. Find and Kill Process
macOS/Linux: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.
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: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):
.env file: