PostgreSQL

​

어디에 쓰이나요?

• 사용자 정보, 게시글, 주문 내역 등 구조화된 데이터를 저장할 때
• Dify, Langfuse, n8n 등 대부분의 애플리케이션이 기본 데이터베이스로 사용
• 트랜잭션, 외래 키 등 데이터 무결성이 필요한 경우

​

Docker Compose

services:
  postgres:
    image: postgres:17
    container_name: postgres
    restart: unless-stopped
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: changeme
      POSTGRES_DB: postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

​

실행

docker compose up -d

​

접속 확인

docker exec -it postgres psql -U postgres

SELECT version();

​

기본 정보

​

환경 변수

​

라이선스

​

참고

• Docker Hub - postgres
• PostgreSQL 공식 문서

​

설치 점검 목록

• docker compose up -d 후 docker compose ps로 컨테이너 상태를 확인했습니다.
• 기본 포트/계정/비밀번호를 문서대로 점검했습니다.
• 운영용으로 사용할 때 기본 비밀번호/시크릿 값을 변경했습니다.
• 장애 분석을 위해 docker compose logs -f 확인 방법을 숙지했습니다.

​

문제 해결 가이드

• 컨테이너가 실행되지 않으면 docker compose logs -f로 오류 원인을 먼저 확인합니다.
• 포트 충돌이 나면 기존 프로세스를 종료하거나 포트 매핑 값을 변경합니다.
• 이미지 pull 실패 시 네트워크 연결 및 레지스트리 접근 권한을 확인합니다.
• 설정 변경 후 문제가 지속되면 docker compose down 후 다시 up -d로 재기동합니다.

​

관련 문서