CasaOS로 홈서버 첫 시작하기
복잡한 명령어가 부담스러운 초보자를 위한 CasaOS 설치와 첫 설정 가이드
- CasaOS 홈서버는 웹 UI를 이용해 개인 서버와 컨테이너 앱을 비교적 쉽게 관리할 수 있는 구성입니다.
- CasaOS 공식 문서는 현재 Debian 12를 테스트된 권장 시스템으로 안내하고 있습니다.
- 공식 설치 명령 한 줄로 설치를 시작할 수 있지만, 실행 전에 OS와 네트워크 환경을 확인하는 것이 좋습니다.
- CasaOS 앱은 Docker Compose 기반 구성을 활용하므로 Docker의 기본 개념을 함께 알아두면 관리가 쉬워집니다.
- 설치 후에는 계정 설정뿐 아니라 저장장치, 데이터 위치, 업데이트와 백업까지 함께 관리해야 합니다.
CasaOS 홈서버를 찾아보고 있다면 아마 홈서버는 만들어보고 싶지만 처음부터 Docker 명령과 Compose 파일을 직접 다루는 것은 어렵게 느껴졌을 가능성이 큽니다.
홈서버를 처음 만들면 운영체제 설치부터 Docker, 저장장치, 컨테이너, 네트워크까지 낯선 개념이 한꺼번에 등장합니다. CasaOS의 장점은 이 과정에서 자주 하는 작업을 브라우저에서 접근할 수 있는 UI로 묶어준다는 데 있습니다.
다만 CasaOS를 설치한다고 서버 관리 지식이 전혀 필요 없어지는 것은 아닙니다. 앱이 어디에 데이터를 저장하는지, Docker 컨테이너가 무엇인지, 업데이트 전에 무엇을 백업해야 하는지는 여전히 알아두는 편이 좋습니다.
이 글에서는 CasaOS 공식 문서를 기준으로 지원 환경과 설치 방식을 확인하고, 처음 홈서버를 만드는 사람이 어디서부터 시작하면 되는지 순서대로 살펴보겠습니다.
CasaOS 홈서버는 어떤 방식으로 사용하는 걸까?
CasaOS 홈서버를 이해할 때 가장 먼저 알아둘 점은 이름만 보고 일반적인 데스크톱 운영체제와 똑같이 생각하면 안 된다는 것입니다. CasaOS 프로젝트는 공식 GitHub에서 자신을 사용하기 쉬운 오픈소스 개인 클라우드 시스템으로 소개하고 있습니다.
실제 설치 방식도 이를 보여줍니다. 공식 가이드는 Debian이나 Ubuntu Server, Raspberry Pi OS 같은 Linux 시스템을 먼저 설치한 뒤 CasaOS 설치 스크립트를 실행하는 형태로 안내합니다.
즉 일반적인 PC에서 Windows를 지우고 CasaOS ISO 파일 하나를 바로 설치하는 방식으로 이해하기보다, 지원되는 Linux 환경 위에 CasaOS의 관리 기능을 구성한다고 생각하는 편이 초보자에게 이해하기 쉽습니다.
설치가 완료되면 브라우저를 통해 CasaOS UI에 접근하고 서버의 저장공간이나 설치된 앱을 관리할 수 있습니다. 매번 SSH 터미널만 열어 서버를 관리하는 것보다 시각적으로 현재 구성을 파악하기 쉽다는 것이 큰 특징입니다.
특히 앱 관리가 홈서버 입문자에게 편리합니다. CasaOS 생태계의 앱 정의는 Docker Compose를 활용하며, 공식 앱 저장소의 문서에서도 각 앱이 docker-compose.yml을 기반으로 구성되는 구조를 확인할 수 있습니다.
여기서 중요한 점은 CasaOS가 Docker라는 기반을 완전히 없애주는 것은 아니라는 것입니다. 사용자는 웹 UI를 중심으로 앱을 관리할 수 있지만 실제 서비스는 컨테이너와 Compose 구성에 연결됩니다.
그래서 CasaOS를 사용하면 처음부터 모든 Docker 명령을 외울 필요는 없지만, 시간이 지나면서 Docker와 Compose를 조금씩 익히는 것이 좋습니다. 나중에 앱이 실행되지 않거나 데이터를 옮겨야 할 때 구조를 이해하고 있으면 문제를 해결하기 쉬워집니다.
CasaOS의 핵심 가치는 Docker를 다른 기술로 대체하는 것이 아니라 홈서버에서 자주 하는 작업의 진입 장벽을 낮춰주는 데 가깝습니다. 처음에는 UI로 시작하고, 익숙해지면서 Docker Compose와 Linux 명령을 하나씩 배우는 방식이 좋습니다.
CasaOS 홈서버 설치 전 준비할 것
CasaOS 홈서버를 만들기로 했다면 바로 설치 명령부터 실행하기보다 먼저 사용할 Linux 배포판과 하드웨어를 확인하는 것이 좋습니다. 운영체제 조합에 따라 설치 과정과 문제 해결 난도가 달라질 수 있기 때문입니다.
CasaOS 공식 Get Started 문서는 현재 하드웨어 아키텍처로 amd64/x86-64, arm64, armv7을 안내하고 있습니다. 따라서 일반적인 x86 미니 PC뿐 아니라 지원되는 ARM 환경에서도 사용할 수 있습니다.
운영체제는 공식 문서의 지원 상태를 확인하는 것이 더 중요합니다. 현재 공식 가이드에서는 Debian 12를 Tested, Recommended로 표시하고 있습니다.
Ubuntu Server 20.04와 Raspberry Pi OS 역시 공식 지원 목록에서 Tested로 안내됩니다. 반면 다른 Linux 배포판은 커뮤니티 지원이거나 완전하게 테스트되지 않은 상태로 표시된 경우가 있으므로 초보자라면 공식 권장 조합을 우선하는 편이 안전합니다.
여기서 버전 숫자는 특히 주의해야 합니다. “Ubuntu라면 아무 버전이나 공식적으로 동일하게 지원된다”는 식으로 확대해서 이해하면 안 됩니다. CasaOS 문서에 명시된 버전과 실제 설치할 시스템의 버전을 비교해야 합니다.
오래된 PC를 홈서버로 재활용할 때도 마찬가지입니다. CPU가 64비트를 지원하는지만 보는 것이 아니라 유선 네트워크가 안정적인지, 저장장치 상태는 괜찮은지, 장시간 켜둘 때 냉각에 문제가 없는지 확인해야 합니다.
특히 중요한 데이터를 저장할 계획이라면 CasaOS 설치 자체보다 데이터 저장 위치를 먼저 고민하는 편이 좋습니다. 운영체제가 설치된 디스크 하나에 모든 데이터를 몰아넣으면 나중에 시스템을 재설치할 때 관리가 복잡해질 수 있습니다.
처음 CasaOS를 시험한다면 중요한 파일을 바로 옮기기보다 테스트용 장비와 데이터로 먼저 구조를 익혀보세요. 앱 설치, 삭제, 재부팅, 저장 위치 확인까지 한 번 경험한 뒤 실제 파일을 옮기면 실수를 줄일 수 있습니다.
네트워크도 미리 확인해두는 것이 좋습니다. CasaOS 설치 후에는 같은 네트워크의 다른 PC나 스마트폰 브라우저에서 서버에 접근하는 상황이 많으므로 서버가 공유기에서 어떤 IP 주소를 받고 있는지 알아두면 편합니다.
장기간 운영할 서버라면 공유기의 DHCP 예약 기능 등을 이용해 같은 장치가 일정한 내부 IP를 사용하도록 구성하는 방법도 있습니다. 다만 공유기마다 메뉴와 기능 이름이 다르므로 자신의 공유기 공식 설명서를 기준으로 설정해야 합니다.
CasaOS 웹 화면을 인터넷에 바로 노출하는 방식부터 시작하지 마세요. 초보 단계에서는 먼저 같은 내부 네트워크에서 정상적으로 사용하는 구성을 완성하는 편이 좋습니다. 외부 접속이 필요해졌다면 인증과 HTTPS, VPN 또는 리버스 프록시 등 별도의 보안 구성을 이해한 뒤 추가하세요.
설치 전에는 최소한 하드웨어 → 지원 OS → 저장장치 → 내부 네트워크 순서로 점검하면 됩니다. 이 네 가지가 정리되어 있으면 실제 CasaOS 설치 과정은 오히려 간단한 편입니다.
CasaOS 설치하고 처음 접속하는 방법
CasaOS 홈서버의 운영체제와 네트워크 준비가 끝났다면 이제 실제 설치를 진행할 차례입니다. CasaOS 공식 Get Started 문서에서는 터미널에서 설치 스크립트를 실행하는 방법을 안내하고 있습니다.
공식 문서에 안내된 설치 명령은 다음과 같습니다.
curl -fsSL https://get.casaos.io | sudo bash명령의 구조도 간단히 이해해두면 좋습니다. curl을 이용해 CasaOS 측에서 제공하는 설치 스크립트를 가져오고, 이를 관리자 권한으로 실행하는 방식입니다.
인터넷에서 발견한 명령을 의미도 모른 채 복사하는 습관은 피하는 것이 좋습니다. 특히 curl ... | sudo bash처럼 인터넷에서 받은 스크립트를 바로 관리자 권한으로 실행하는 명령은 반드시 공식 문서에서 주소와 명령이 맞는지 확인한 뒤 사용하는 것이 중요합니다.
위 명령은 CasaOS 공식 Get Started 문서에 안내된 설치 방식입니다. 검색 결과나 오래된 블로그에서 복사하기보다 설치 시점의 CasaOS 공식 문서에서 명령이 변경되지 않았는지 다시 확인하는 것을 권장합니다.
설치가 진행되면 필요한 구성 요소가 준비되고 CasaOS 서비스가 설정됩니다. 설치가 완료된 뒤에는 CasaOS가 표시하는 접속 정보를 확인해 웹 인터페이스로 들어갈 수 있습니다.
같은 내부 네트워크에 연결된 PC에서 웹 브라우저를 열고 서버의 IP 주소를 입력하면 CasaOS 화면에 접근할 수 있습니다. 서버의 IP를 모른다면 Linux에서 다음과 같은 명령으로 네트워크 주소를 확인할 수 있습니다.
hostname -I여러 주소가 표시된다면 실제로 공유기와 연결된 네트워크 인터페이스의 내부 IP를 확인해야 합니다. 일반적인 가정용 네트워크에서는 192.168.x.x나 10.x.x.x 형태의 사설 IP를 볼 수 있습니다.
예를 들어 서버의 내부 IP가 192.168.0.50이라면 같은 네트워크에 연결된 다른 기기의 브라우저에서 해당 주소로 접속하는 방식입니다. 실제 주소는 자신의 서버 환경에 따라 달라집니다.
첫 접속 후 가장 먼저 할 일
CasaOS의 초기 화면에 정상적으로 접근했다면 먼저 초기 계정 설정을 완료합니다. 이후 곧바로 앱을 여러 개 설치하기보다 현재 서버 상태와 저장공간 구성을 먼저 살펴보는 편이 좋습니다.
특히 앞으로 사진, 영상, 문서처럼 중요한 데이터를 저장할 계획이라면 앱을 설치하기 전에 어느 디스크에 데이터를 저장할 것인지 생각해두는 것이 중요합니다.
처음에는 운영체제가 설치된 SSD 하나만 사용할 수도 있지만, 나중에 별도 HDD나 SSD를 추가한다면 데이터 구조를 다시 변경해야 할 수 있기 때문입니다.
CasaOS 첫 화면이 열렸다고 바로 미디어 서버나 개인 클라우드 앱부터 설치하기보다 서버 IP, 저장장치, 남은 용량, 데이터 저장 위치를 먼저 확인하세요. 초기에 저장 구조를 정리해두면 나중에 데이터를 옮기는 작업을 줄일 수 있습니다.
서버의 내부 IP도 가능하면 자주 바뀌지 않도록 관리하는 편이 좋습니다. DHCP 환경에서는 서버를 재부팅하거나 공유기 상태가 변경되면서 다른 주소가 할당될 가능성이 있습니다.
공유기가 지원한다면 해당 서버의 MAC 주소를 기준으로 DHCP 예약을 설정해 일정한 내부 IP를 받도록 구성할 수 있습니다. 공유기마다 설정 방법이 다르므로 해당 제조사의 공식 가이드를 확인하면 됩니다.
홈서버에서 내부 IP를 일정하게 유지하면 CasaOS뿐 아니라 이후 설치할 Uptime Kuma, Grafana, 파일 서버 등 여러 웹 서비스의 주소를 관리하기 쉬워집니다. 홈서버를 장기간 운영할 생각이라면 초기에 정리해두기 좋은 부분입니다.
CasaOS에서 첫 앱 설치하기
CasaOS 홈서버를 사용하는 이유 가운데 하나는 Docker 기반 서비스를 비교적 쉽게 설치하고 관리할 수 있다는 점입니다. 직접 Docker Compose 파일을 작성하는 방식과 달리 CasaOS에서는 App Store 형태의 인터페이스를 이용할 수 있습니다.
CasaOS 공식 AppStore 프로젝트를 보면 앱 정의에 Docker Compose 규격을 활용하고 있습니다. 따라서 사용자는 간단한 웹 UI를 보지만 그 아래에서는 컨테이너 기반 서비스가 구성되는 방식이라고 이해하면 됩니다.
이 구조를 알고 있으면 CasaOS의 장점도 더 명확하게 이해할 수 있습니다. Docker를 완전히 숨기는 것이 아니라 자주 사용하는 설정을 GUI에서 접근하기 쉽게 만든 것에 가깝습니다.
첫 앱은 가벼운 서비스부터
처음부터 사진 관리나 대규모 미디어 라이브러리처럼 저장공간과 CPU 사용량이 큰 서비스를 구성할 필요는 없습니다. 먼저 비교적 구조가 단순한 앱을 하나 설치하면서 CasaOS의 기본 관리 흐름을 익히는 것이 좋습니다.
앱을 설치한 뒤에는 최소한 다음 내용을 확인해보세요.
- 앱이 정상적으로 실행되는가?
- 브라우저에서 해당 서비스에 접속할 수 있는가?
- 어떤 포트를 사용하고 있는가?
- 데이터가 어느 경로에 저장되는가?
- 컨테이너를 재시작해도 데이터가 유지되는가?
여기서 포트는 홈서버를 사용하면서 자주 만나게 되는 개념입니다. 하나의 서버에서 여러 웹 서비스를 실행하기 때문에 IP 주소는 같더라도 서로 다른 포트를 이용해 서비스를 구분하는 경우가 많습니다.
예를 들어 개념적으로 아래와 같은 형태가 될 수 있습니다.
서버 IP:서비스 포트
192.168.0.50:포트번호위 주소의 포트번호는 특정 CasaOS 앱의 실제 기본 포트를 의미하는 것이 아니라 구조를 설명하기 위한 예시입니다. 실제 포트는 설치한 앱의 설정에서 확인해야 합니다.
여러 앱을 설치하다 보면 어떤 서비스가 어느 포트를 사용하는지 기억하기 어려워질 수 있습니다. 이후 리버스 프록시와 도메인을 연결하는 이유 가운데 하나도 이런 주소를 보다 편리하게 관리하기 위해서입니다.
두 서비스가 호스트에서 동일한 포트를 사용하도록 설정되면 정상적으로 실행되지 않을 수 있습니다. 앱을 직접 추가하거나 포트 설정을 수정했다면 기존 서비스가 사용하는 포트와 겹치지 않는지 확인하세요.
앱을 설치했다면 삭제도 한 번 테스트해보는 것이 좋습니다. 단, 중요한 데이터를 저장한 앱에서는 바로 시도하지 말고 테스트용 앱을 대상으로 진행하세요.
여기서 확인해야 하는 것은 앱을 삭제했을 때 데이터까지 어떻게 처리되는가입니다. Docker 환경에서는 컨테이너 자체와 영구 데이터를 저장하는 볼륨 또는 바인드 마운트가 서로 다른 개념이기 때문입니다.
컨테이너를 삭제했다고 모든 데이터가 반드시 함께 없어지는 것도 아니며, 반대로 사용자가 삭제 옵션이나 저장 경로를 제대로 확인하지 않으면 필요한 데이터를 잃을 수도 있습니다.
CasaOS를 제대로 배우는 가장 좋은 방법은 앱을 많이 설치하는 것이 아니라 하나의 테스트 앱을 설치하고 실행 → 접속 → 재시작 → 저장 위치 확인 → 삭제까지 경험해보는 것입니다. 이 과정을 이해하면 이후 다른 셀프호스팅 앱도 훨씬 쉽게 관리할 수 있습니다.
CasaOS AppStore에 원하는 서비스가 없더라도 Docker 생태계의 다른 애플리케이션을 추가해서 사용하는 방법을 검토할 수 있습니다. 다만 처음 홈서버를 시작하는 단계라면 공식 또는 신뢰할 수 있는 앱 구성을 우선 사용하면서 Docker 구조를 익히는 편이 안전합니다.
자주 묻는 질문
일반적인 데스크톱 운영체제처럼 ISO를 설치하는 방식으로 생각하기보다는 Linux 시스템 위에 설치해 홈서버와 앱을 웹 UI로 관리할 수 있게 해주는 환경으로 이해하는 편이 좋습니다. CasaOS 공식 설치 가이드 역시 Debian, Ubuntu Server, Raspberry Pi OS 등의 Linux 환경을 기반으로 설치하는 방식을 안내합니다.
CasaOS 공식 Get Started 문서에서는 Debian 12를 Tested, Recommended로 안내합니다. 설치 시점에는 공식 문서에서 현재 지원되는 운영체제와 버전을 다시 확인하는 것이 좋습니다.
처음 시작할 때 Docker 명령을 모두 알고 있을 필요는 없습니다. CasaOS의 웹 UI를 이용해 앱을 설치하고 관리할 수 있습니다. 다만 앱이 Docker 컨테이너를 기반으로 동작하므로 장기간 운영한다면 컨테이너, 이미지, 볼륨, 포트 정도의 기본 개념은 익혀두는 것이 좋습니다.
지원되는 아키텍처와 Linux 환경을 사용할 수 있다면 검토할 수 있습니다. 다만 실제 활용 가능성은 CPU와 메모리뿐 아니라 저장장치 상태, 네트워크, 전력 소비, 냉각 그리고 설치할 앱의 요구 사양에 따라 달라집니다.
필요합니다. 홈서버에 저장된 원본 한 개만 가지고 있다면 저장장치 고장, 실수로 인한 삭제, 데이터 손상 등에 대비하기 어렵습니다. 중요한 파일은 서버와 분리된 다른 저장 위치에도 복사본을 유지하는 것이 좋습니다.
관리 화면이나 앱 포트를 단순 포트포워딩으로 바로 인터넷에 공개하기보다는 필요한 서비스와 접근 방식을 먼저 구분하는 것이 좋습니다. 외부 접속이 필요하다면 인증, HTTPS, VPN, 리버스 프록시, 업데이트와 방화벽 등 관련 보안 요소를 함께 검토해야 합니다.
📖 핵심 용어 미니 사전
CasaOS를 처음 사용하면서 자주 만나게 되는 용어를 간단히 정리했습니다.
Linux 환경에 설치해 개인 서버와 컨테이너 기반 앱을 웹 UI에서 관리할 수 있도록 구성된 오픈소스 개인 클라우드 시스템입니다.
Docker 이미지를 기반으로 실행되는 격리된 애플리케이션 환경입니다. CasaOS에서 설치하는 여러 서비스의 기반으로 사용됩니다.
컨테이너 서비스와 포트, 볼륨, 환경 변수 등의 구성을 YAML 파일로 정의하고 실행하는 방식입니다.
컨테이너가 삭제되거나 다시 만들어져도 필요한 데이터를 지속적으로 저장할 수 있도록 사용하는 Docker의 저장 방식입니다.
한 서버에서 여러 네트워크 서비스를 구분할 때 사용하는 번호입니다. 같은 서버 IP에서도 서비스마다 서로 다른 포트를 사용할 수 있습니다.
공유기가 특정 장치에 일정한 내부 IP 주소를 할당하도록 설정하는 기능입니다. 지원 여부와 설정 방법은 공유기마다 다릅니다.
🔗 공식 자료
📖 출처
- CasaOS Wiki — Get Started 및 공식 설치 방법
- CasaOS GitHub — 프로젝트 개요와 지원 환경
- CasaOS AppStore GitHub — Docker Compose 기반 앱 구성
- Docker Docs — Storage, Volume, Bind Mount 구조
- Docker Docs — Container 및 Docker Compose 기본 개념
CasaOS 홈서버는 Linux와 Docker를 처음부터 CLI만으로 관리하기 어려운 사용자에게 홈서버를 시작하기 쉬운 웹 UI를 제공합니다. 처음에는 CasaOS로 앱 하나를 설치해보고, 이후 저장 경로·포트·Docker·백업·네트워크를 하나씩 이해하면서 서버를 확장하는 방식이 좋습니다.
