Skip to content

docs: README 업데이트 - Rancher 및 Docker 충돌 해소 및 포트 관련 트러블슈팅 가이드 추가#1

Open
hankyo-sorohan wants to merge 2 commits into
mainfrom
chore/readme-troubleshooting
Open

docs: README 업데이트 - Rancher 및 Docker 충돌 해소 및 포트 관련 트러블슈팅 가이드 추가#1
hankyo-sorohan wants to merge 2 commits into
mainfrom
chore/readme-troubleshooting

Conversation

@hankyo-sorohan
Copy link
Copy Markdown
Collaborator

@hankyo-sorohan hankyo-sorohan commented Apr 16, 2026

작업 내용

README.md 파일 내 Docker Compose 환경 구성 시 사전에 놓치기 쉬운 설정과 트러블슈팅 가이드를 추가했습니다.

상세 변경 사항

  • 사전 요구사항 (Prerequisites):
    • Git 설치 가이드(winget, brew) 추가
    • Rancher Desktop 설치 후 컨테이너 런타임으로 반드시 **dockerd (moby)**를 선택해야 함을 강조
  • Quick Start 오안내 방지: docker compose up 실행 전 반드시 Docker/Rancher Desktop을 켜놓아야 한다는 주석 추가
  • 윈도우/Rancher 통합 트러블슈팅:
    • Docker & Rancher Desktop 동시 설치 시 발생하는 CLI 충돌 및 포트 점유 안내 및 해결 권고
    • 윈도우 호스트(WSL) 포트 포워딩 꼬임 해결(netsh 정리) 가이드 보충

테스트/확인 사항

  • 마크다운(Markdown) 포맷팅 및 내용 정상 표출 검증

@hankyo-sorohan hankyo-sorohan changed the title docs: add troubleshooting for exec format error and Windows port conf… docs: README 업데이트 - Rancher 및 Docker 충돌 해소 및 포트 관련 트러블슈팅 가이드 추가 Apr 16, 2026
@hankyo-sorohan hankyo-sorohan force-pushed the chore/readme-troubleshooting branch 2 times, most recently from 84c352d to 0049af4 Compare April 16, 2026 01:17
@hankyo-sorohan hankyo-sorohan force-pushed the chore/readme-troubleshooting branch from 0049af4 to 7ed5873 Compare April 16, 2026 01:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant