Skip to main content
포트 충돌 문제와 해결 방법을 다룹니다.

개발 서버 포트 충돌

증상

원인

지정된 포트에서 다른 프로세스가 이미 실행 중입니다.

해결 방법

1. 프로세스 확인 및 종료

macOS/Linux:
Windows:

2. 포트 수동 지정

sonamu.config.ts:

Sonamu UI 접근

설명

Sonamu UI는 API 서버와 같은 포트를 사용하며, /sonamu-ui 경로로 접근합니다.
Sonamu UI 접근: http://localhost:10280/sonamu-ui

여러 프로젝트 동시 실행

증상

여러 Sonamu 프로젝트를 동시에 실행하려는데 포트가 충돌합니다.

해결 방법

각 프로젝트마다 다른 포트 사용: 프로젝트 A:
프로젝트 B:

PostgreSQL 포트 충돌

증상

원인

PostgreSQL이 실행되지 않았거나, 다른 프로세스가 5432 포트를 사용 중입니다.

해결 방법

1. PostgreSQL 실행 확인

2. 다른 포트로 PostgreSQL 실행

PostgreSQL 설정 파일(postgresql.conf)에서:
재시작 후 .env 파일 업데이트:

3. 포트 충돌 프로세스 확인

관련 문서