🛠️ 맥미니 서버 운영기: 원격 재부팅 후 Docker를 살리다

Docker Desktop 대신 Colima로 해결한 실전 사례

🖥️ 맥미니를 서버로 사용하며 벌어진 일

최근 맥미니를 개인 서버로 사용하고 있습니다. SSH를 통해 원격으로 접속해 Docker를 사용하며 웹 애플리케이션 테스트나 데이터 분석 작업을 진행했죠.

하지만 어느 날, 맥미니의 응답이 느려졌습니다. “재부팅이 정답이겠지?”라는 생각에 SSH로 접속해 재부팅을 시도했습니다.

1

sudo reboot

잠시 기다린 뒤, 다시 SSH로 연결은 잘 되었는데…

🚨 Docker 데몬 실행 오류

Docker 상태를 확인하려고 docker ps 명령어를 입력했지만 다음과 같은 오류가 떴습니다.

1
2

docker ps
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

Docker 데몬이 실행되지 않는 상황!

이때부터 악몽의 시작이었습니다.

🚫 Docker Desktop 실행 실패

혹시 Docker Desktop을 실행하면 해결될까 싶어 open 명령을 사용했지만:

1

open /Applications/Docker.app

결과는 다음과 같았습니다.

1

Error Domain=RBSRequestErrorDomain Code=5 "Launch failed."

🙅‍♂️ SSH 원격 환경에서는 Docker Desktop이 실행되지 않는다는 점을 깨달았습니다.

🛠️ 해결 시도: launchctl도 실패

“그럼 시스템 서비스로 Docker를 실행하면 어떨까?”

다음 명령을 실행했습니다.

1

sudo launchctl load -w /Library/LaunchDaemons/com.docker.docker.plist

결과는 또 실패. 😓

1
2

Load failed: 5: Input/output error
Try running `launchctl bootstrap` as root for richer errors.

여기까지 오니 마음이 조급해졌습니다.

🧠 ChatGPT와 함께 찾은 해결책: Colima

이제는 Docker Desktop을 포기하고 대안을 찾기 시작했습니다. 이때 ChatGPT가 제안한 도구는 바로 Colima였습니다.

Colima란?

Colima는 macOS에서 Docker를 가상 머신을 통해 가볍고 빠르게 실행할 수 있는 도구입니다.

🔧 Colima 설치 및 시작

1. Colima 설치

Homebrew를 통해 Colima를 설치합니다.

1

brew install colima

2. Colima 실행 및 상태 확인

Colima를 실행하고 상태를 확인해 봅니다.

1
2

colima start
colima status

정상적으로 실행되면 다음과 같은 상태 메시지가 나옵니다:

1
2
3

INFO[0000] colima is running using macOS Virtualization.Framework
INFO[0000] runtime: docker
INFO[0000] socket: unix:///Users/macmini/.colima/default/docker.sock

🧩 Docker CLI와 Colima 소켓 연결

문제는 Docker CLI가 기본적으로 /var/run/docker.sock를 찾기 때문에 Colima의 소켓과 연결해줘야 합니다.

다음 명령으로 환경 변수를 설정합니다.

1

export DOCKER_HOST=unix:///Users/macmini/.colima/default/docker.sock

🎉 Docker 데몬 다시 살아나다!

환경 변수를 설정한 후, docker ps 명령어를 다시 실행했습니다.

1

docker ps

결과는 성공! 🎉

1

CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

📋 전체 과정 정리

1. 문제 상황:

• 원격 SSH 환경에서 Docker Desktop 실행 실패

• launchctl로 Docker 데몬 시작 실패

2. 해결책:

• Colima를 Homebrew로 설치

• Colima 시작 후 소켓 경로 확인

• DOCKER_HOST 환경 변수 설정

3. 최종 코드 요약:

1
2
3
4

# Colima 설치 및 시작brew install colima
colima start
# Docker 소켓 연결export DOCKER_HOST=unix:///Users/macmini/.colima/default/docker.sock
# Docker 상태 확인docker ps

🧠 왜 Colima인가?

• 경량화된 VM을 사용해 Docker 데몬을 실행
• SSH 원격 환경에서도 문제없이 작동
• Docker Desktop과 달리 GUI가 필요 없음

💡 교훈: 맥미니 서버 운영 팁

1. Docker Desktop의 한계: SSH 환경에서는 GUI 기반 앱을 실행하기 어렵다.
2. Colima 활용: 원격 환경에서 Docker를 실행하는 강력한 대안.
3. 환경 변수 설정: Docker CLI 소켓을 올바르게 연결하는 것이 핵심이다.

🚀 결론: 원격 맥미니 운영, 이제 문제없다!

이번 경험을 통해 원격 환경에서 Docker 데몬을 실행하는 방법을 배웠습니다.

Docker Desktop 대신 Colima를 사용하면 가볍고 빠르게 서버를 운영할 수 있습니다.

혹시 비슷한 문제를 겪는 분이 있다면 이 글이 도움이 되길 바랍니다.

원격 재부팅 후 Docker 오류를 극복한 제 경험이 작은 해결책이 되었으면 좋겠네요! 😊

읽어주셔서 감사합니다!

궁금한 점이나 더 나은 해결 방법이 있다면 댓글로 알려주세요! 🚀