# 자체 호스팅 개요

> 자체 Onetime Secret 인스턴스를 운영한다는 것이 무엇을 의미하는지, 어떤 인증 모드를 먼저 선택해야 하는지, 설치 및 운영자 안내가 어디에 있는지 설명합니다.

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

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

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

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

[Simple 또는 Full](/en/self-hosting/simple-or-full-auth)에서는 각 모드가 무엇을 가능하게 하는지, 해당 데이터베이스가 어디에 있어야 하는지, 나중에 모드를 전환하는 것이 얼마나 어려운지를 다룹니다.

## 설치 경로를 선택하세요

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

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

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

## 시스템 요구 사항

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

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

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

## 운영자 전용 작업

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

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

```bash
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`로 표시하며 수정하지 않습니다.

이 작업의 최종 사용자 관점은 [소유권과 이전](/en/organizations/ownership-and-transfer)에서 다루며, 사용자들은 운영자에게 문의하기 전에 그 페이지를 먼저 읽게 될 것입니다.

## 도움 받기

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