콘텐츠로 건너뛰기

사전 릴리스 문서 사이트를 보고 있습니다여기 콘텐츠는 테스트용이며 실제 문서와 다를 수 있습니다.

실제 문서로 이동

자체 호스팅 개요

자체 인스턴스를 운영하면 모든 비밀 메시지, 계정, 로그 한 줄까지 사용자가 직접 제어하는 인프라에 머무릅니다. 계정을 어떻게 인증할지, 인스턴스를 공용 인터넷에서 접근할 수 있게 할지 여부, 인터페이스에 어떤 브랜딩을 적용할지 모두 직접 결정합니다.

먼저 인증 모드를 선택하세요

“먼저 인증 모드를 선택하세요” 섹션

인증 모드에 따라 함께 실행해야 하는 구성 요소가 달라지므로, 설치 전에 먼저 정하세요.

simple은 기본값이며 Valkey/Redis 데이터 저장소만 필요합니다. full은 계정용 SQL 데이터베이스를 추가하며, 기본값은 sqlite://data/auth.db의 SQLite입니다. PostgreSQL은 필수가 아니라 지원되는 선택 사항입니다. 컨테이너 환경에서는 이 파일이 재시작 후에도 유지되도록 마운트된 볼륨에 있어야 합니다.

Simple 또는 Full에서는 각 모드가 무엇을 가능하게 하는지, 해당 데이터베이스가 어디에 있어야 하는지, 나중에 모드를 전환하는 것이 얼마나 어려운지를 다룹니다.

설치 경로를 선택하세요

“설치 경로를 선택하세요” 섹션

이미 운영 중인 Valkey나 Redis가 있고 빠르게 시작하고 싶으신가요? Docker로 설치의 단일 docker run 형식을 사용하면 자동 생성된 SECRET 값으로 포트 3000에서 인스턴스가 실행됩니다. 인스턴스가 실행된 뒤에도 이 페이지의 나머지 내용은 그대로 적용됩니다.

  • 이미지와 변형 — 게시된 이미지 중 어떤 것을 실행해야 하는지, 릴리스 태그가 어떻게 동작하는지 설명합니다.
  • Docker로 설치 — 프로젝트가 제공하는 두 가지 Compose 스택을 다룹니다.
  • Linux에 설치 — Debian 또는 Ubuntu에 베어메탈로 설치합니다. 프로젝트의 설치 테스트는 다른 배포판 계열을 다루지 않습니다.
  • 서비스로 실행 — 저장소가 제공하는 systemd 유닛과, systemd가 없는 호스트를 위한 Procfile 러너를 다룹니다.
  • 리버스 프록시와 TLS — 애플리케이션은 TLS를 직접 종단하지 않으므로 앞단에 프록시가 있는 것을 전제로 합니다. 인스턴스를 외부에 노출하기 전에 읽어 보세요.
  • 설치 확인 — 다른 사람에게 넘기기 전에 인스턴스가 실제로 서비스 중인지 검증하고, 첫 계정을 만드세요. 사이트 운영자 역할은 CLI에서만 부여할 수 있습니다.

기존 설치를 업그레이드하시나요? 업그레이드 가이드에는 사용 가능한 가이드가 최신순으로 나열되어 있습니다. 현재 실행 중인 릴리스 바로 다음 가이드부터 시작해 순서대로 진행하고, 그 사이의 모든 릴리스에 대한 릴리스 노트를 읽어 보세요.

인증 모드 simple로 실행하는 인스턴스의 권장 사양:

  • CPU 코어 2개 이상
  • RAM 2GB 이상
  • 디스크 공간 10GB 이상

PostgreSQL, 백그라운드 워커, 스케줄러까지 함께 실행하는 full 모드 배포에는 대략 그 두 배가 필요합니다.

일부 관리 작업은 애플리케이션에 화면이 없으며 인스턴스의 명령줄에서 수행합니다.

조직을 새 소유자에게 이전하는 작업이 대표적입니다. 조직 소유자에게는 이를 위한 화면이나 엔드포인트가 없으므로 이전은 운영자가 직접 수행해야 합니다. 아래 명령을 사용하세요. 자동화가 필요하다면 Colonel API가 같은 작업을 POST /api/colonel/organizations/:org_id/transfer-ownership으로 제공합니다. 이 엔드포인트는 colonel 역할이 필요하고, 확인 수단으로 조직 이름을 받으며, 미리보기 없이 즉시 적용됩니다.

터미널 창
bin/ots org transfer-ownership ORG NEW_OWNER

ORG는 조직의 공개 ID(extid, CLI가 출력하는 ID) 또는 내부 ID(objid)입니다. NEW_OWNER는 이메일 주소, 고객 extid 또는 Rodauth 계정 ID이며, 이미 활성 멤버여야 합니다. 이 명령은 고객을 새로 만들지 않으므로, 멤버가 아니라면 먼저 bin/ots memberships add ORG CUSTOMER를 실행하세요.

--yes 없이 실행하면 아무것도 변경하기 전에 이전 계획을 먼저 세워, 누가 소유권을 잃는지, 몇 개의 소유자 멤버십이 어떤 역할로 강등되는지 출력한 뒤 확인을 요청합니다. n으로 답하는 것이 이전을 미리 보는 방법입니다. 옵션은 --demote-to ROLE(owner를 제외한 모든 멤버십 역할, 기본값 admin), --yes(-y와 -f도 가능), --json입니다.

기존 소유자는 제거되지 않고 강등됩니다. 이 작업은 기존 소유자를 강등하기 전에 새 소유자를 먼저 승격합니다. 단독 소유자 보호 장치가 다른 모든 순서를 거부하기 때문입니다. 따라서 이 두 번의 쓰기가 진행되는 동안 조직에는 소유자 멤버십이 두 개 존재하며, bin/ots org doctor는 검사 4(membership_role_sync)를 경고로 보고합니다. 이 구간 안에서 이전이 중단되었다면 org doctor가 아니라 소유권 이전 명령을 다시 실행하세요. 소유권 이전은 멱등성이 있으며 다른 모든 소유자를 강등합니다. org doctor는 해당 검사를 repairable: false로 표시하며 수정하지 않습니다.

이 작업의 최종 사용자 관점은 소유권과 이전에서 다루며, 사용자들은 운영자에게 문의하기 전에 그 페이지를 먼저 읽게 될 것입니다.

  • GitHub 저장소 — 소스 코드, 릴리스 노트, 제공되는 Compose 스택이 있습니다.
  • 이슈 트래커 — 버그 신고 시 릴리스 태그와 관련 로그 줄을 함께 적어 주세요.
  • 그 외 모든 문의는 직접 문의하기를 이용하세요.