헤르메스 에이전트를 VPS에 올리는 일은 컨테이너 하나를 실행하는 것으로 끝나지 않습니다. AI 모델 인증, 메시지 창구, 작업 파일, 노트 동기화가 이어져야 실제 업무 환경이 됩니다. 어느 한 부분이 빠지면 대화는 가능해도 결과를 쌓고 다시 꺼내 쓰는 흐름은 만들기 어렵습니다.
앞선 글에서 헤르메스 에이전트를 어디에 설치할지, Codex와 Telegram을 어떻게 연결할지, 예약 작업을 어떤 기준으로 운영할지 나누어 살펴봤습니다. 이번 글은 그 흐름을 실제 Hostinger VPS 구축 순서로 묶은 여섯 번째 글입니다.
전체 설치 절차를 그대로 옮기기보다, 무엇을 먼저 연결하고 어느 시점에 상태를 확인해야 하는지 7단계로 정리합니다. 상세 화면과 명령은 글 마지막의 PDF 가이드에서 확인할 수 있습니다.
1. Hostinger 가입과 VPS 환경을 준비합니다
먼저 Hostinger 계정을 만들고 VPS를 선택합니다. 이 가이드에서는 헤르메스 에이전트와 Obsidian Headless를 함께 운영하는 기준으로 KVM 2와 Ubuntu 24.04 LTS를 사용합니다.
결제 전에 가격만 볼 일은 아닙니다. 약정 기간, 갱신 조건, 운영체제 선택, Docker Manager 제공 여부를 함께 확인해야 이후 설치 흐름이 끊기지 않습니다.
2. Docker Manager에서 헤르메스 에이전트를 배포합니다
Hostinger Docker Manager에서 오른쪽 위 컴포즈 메뉴를 열고 원클릭 배포를 선택합니다. 이어서 카탈로그 검색창에 Hermes Agent를 입력하고, 검색 결과의 Hermes Agent 카드를 선택해 배포합니다.
배포가 끝나면 프로젝트 상태가 Running인지 확인합니다. 이 화면의 열기는 헤르메스 전용 대시보드로 들어가는 경로이고, 터미널은 컨테이너 안에서 헤르메스 명령을 실행하는 공간입니다. 다음 단계의 AI 모델 인증은 터미널에서 진행합니다.
3. OpenAI Codex로 AI 모델을 인증합니다
헤르메스 에이전트 컨테이너 터미널에서 OpenAI Codex 계정을 인증하고 사용할 모델을 선택합니다. 설치가 되어 있어도 모델 인증이 끝나지 않으면 헤르메스는 응답을 만들 수 없습니다.
인증 뒤에는 모델 선택 화면을 다시 열고, 실제 계정에 표시되는 모델을 선택합니다. 마지막으로 상태 점검 명령과 짧은 시험 대화를 통해 헤르메스가 모델 응답을 반환하는지 확인합니다.
4. 노트북 Hermes Desktop을 VPS에 연결합니다
VPS는 상시 실행 환경이고, Hermes Desktop은 노트북에서 VPS를 관리하는 작업 화면입니다. Hermes Desktop을 설치한 뒤 Remote Gateway 연결에 VPS 헤르메스 주소를 등록합니다.
연결이 끝나면 노트북에서 새 대화를 열어 VPS의 모델이 응답하는지 확인합니다. 이 단계를 거치면 브라우저 터미널을 계속 열어두지 않고도 VPS의 헤르메스 작업 환경에 접속할 수 있습니다.
5. Telegram을 헤르메스의 메시지 창구로 연결합니다
Telegram Bot은 헤르메스에게 지시를 보내고 결과를 받는 창구입니다. BotFather에서 봇을 만든 뒤, Hermes Desktop 왼쪽의 Messaging 메뉴에서 Telegram 연결을 추가합니다.
이때 Bot Token과 허용 사용자 숫자 ID를 등록합니다. 연결이 끝난 뒤 Telegram에서 상태 확인 명령을 보내 응답을 확인하면, PC 밖에서도 VPS 헤르메스에 작업을 요청할 수 있습니다.
6. Obsidian Headless로 작업 노트를 연결합니다
헤르메스가 만든 노트와 Mac·모바일에서 편집한 노트를 같은 Obsidian 볼트에서 관리하려면 Obsidian Headless가 필요합니다. Headless는 화면 없이 VPS에서 실행되며, VPS 볼트와 Obsidian Sync 사이의 양방향 동기화를 담당합니다.
이 단계에서는 주력 볼트를 먼저 확인하고, VPS 경로와 실행 권한을 맞춘 뒤 Dockerfile과 Compose 파일을 구성합니다. 이어서 이미지 빌드, Obsidian 로그인, 원격 볼트 선택, 동기화 정책 설정, 양방향 시험, 연속 동기화 순서로 진행합니다.
운영 볼트에는 Google Drive 데스크톱 동기화나 다른 동기화 도구를 함께 연결하지 않습니다. 같은 파일을 여러 동기화 도구가 동시에 다루면 충돌 원인을 판단하기 어려워집니다.
7. Google Drive는 선택 파일 작업용으로 연결합니다
Google Drive는 Obsidian 볼트의 두 번째 동기화 도구가 아닙니다. 필요한 파일을 검색하고, 지정한 파일만 내려받아 작업한 뒤, 승인한 결과 파일을 올리는 보조 작업 공간으로 사용합니다.
Google Cloud에서 Drive API와 Desktop OAuth를 설정하면 헤르메스가 지정 범위에서 Google Drive 파일을 다룰 수 있습니다. OAuth JSON, 인증 코드, 토큰은 Obsidian 노트나 채팅에 남기지 않고 VPS의 제한된 경로와 브라우저·터미널 입력창에서만 관리합니다.
설치보다 연결 순서가 중요합니다
헤르메스 환경은 VPS, AI 모델, Desktop, Telegram, Obsidian, Google Drive가 각각 따로 놓인 구성이 아닙니다. VPS는 상시 실행을 맡고, Desktop과 Telegram은 작업 요청 창구가 되며, Obsidian은 작업 기록을 쌓는 공간이 됩니다. Google Drive는 선택한 외부 파일을 다루는 보조 연결입니다.
그래서 설치 순서가 중요합니다. 앞 단계의 연결 상태를 확인한 뒤 다음 단계로 넘어가면, 문제가 생겨도 원인을 좁힐 수 있습니다. 7 STEP 가이드는 이 순서를 따라 실제 구축 화면과 명령을 확인하도록 구성했습니다.
함께 보면 좋은 자료
함께 읽을 글
- ⑤ 헤르메스 에이전트의 예약 작업은 어떻게 운영할까: 반복되는 일을 서버에 맡기는 기준 — VPS에 구축한 뒤 반복 작업의 대상, 실행 시점, 결과 확인 방식을 정리할 때 이어서 볼 수 있습니다.
책 추천
- 팔리는 블로그 & SNS 글쓰기 with 챗GPT — VPS와 에이전트로 모은 아이디어와 자료를 실제 발행 글로 연결하는 관점을 함께 살펴볼 수 있습니다.
강의 추천
- 클로드 일하는 법(초급+): 스킬·코워크·옵시디언 — 도구와 자료, 작업 기준을 한 흐름으로 연결하는 방법을 다룹니다.
가이드 다운로드
- Hostinger VPS Hermes 구축 가이드.pdf 다운로드 — Hostinger 가입부터 Hermes·Telegram·Obsidian·Google Drive 연결까지 7 STEP으로 정리했습니다.
Hostinger VPS 추천 링크
- Hostinger VPS 요금제와 20% 할인 혜택 확인하기 — 이 링크는 추천 링크입니다. 할인율·적용 조건·약정 기간·갱신 요금은 결제 화면에서 최종 확인합니다.
