stoatchat/self-hosted

어떤 프로젝트인가요?

핵심 기능

• 01Docker Compose로 백엔드, 웹 프런트엔드, 파일 서버, 메타데이터 및 이미지 프록시를 함께 배포합니다.
• 02generate_config.sh로 시크릿과 Revolt.toml 구성을 생성합니다.
• 03사용자 지정 S3 스토리지, 이메일 인증, captcha, 모바일 푸시 알림을 지원합니다.
• 04리버스 프록시 구성, 초대 전용 설정, NGINX 관련 가이드를 제공합니다.
• 05업그레이드 단계와 과거의 호환성을 깨는 변경 사항에 대한 마이그레이션 방법을 문서화합니다.

활용 사례

• 자체 VPS에서 커뮤니티나 팀을 위한 비공개 채팅 서버를 운영합니다.
• 직접 관리하는 도메인에서 자체 스토리지와 데이터를 사용해 Stoat 인스턴스를 호스팅합니다.
• 더 넓은 범위에 배포하기 전에 Stoat 스택을 테스트하거나 평가합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/stoatchat/self-hosted stoat
2. 2

   프로젝트 디렉터리로 이동합니다

   cd stoat
3. 3

   도메인을 지정해 설정을 생성합니다

   ./generate_config.sh your.domain
4. 4

   인스턴스를 백그라운드에서 시작합니다

   docker compose up -d

사용 전 알아둘 점

• !Docker를 실행하고 도메인 이름이 연결된 서버가 필요하므로 셀프 호스팅에는 설정 작업이 필요합니다.
• !대부분의 공식 클라이언트는 셀프 호스팅 인스턴스를 지원하지 않습니다. 웹 클라이언트와 PWA가 가장 잘 작동합니다.
• !네트워크 사용 시 소스 공개 의무가 있는 카피레프트 라이선스인 AGPL-3.0에 따라 제공됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

self-hosted은(는) 무엇인가요?

백엔드, 웹 프런트엔드, 파일 서버와 프록시를 포함한 Stoat 전체 인스턴스를 배포하는 Docker 기반 구성입니다. 이 저장소는 자체 서버에서 완전한 Stoat 인스턴스를 실행하기 위한 Docker Compose 구성과 단계별 안내를 제공합니다. 배포 구성에는 백엔드, 웹 프런트엔드, 파일 서버, 메타데이터 및 이미지 프록시가 포함됩니다.

self-hosted은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

self-hosted은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

self-hosted은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. self-hosted의 마지막 커밋은 2026년 10월 7일입니다.

self-hosted은(는) 어디에 사용할 수 있나요?

자체 VPS에서 커뮤니티나 팀을 위한 비공개 채팅 서버를 운영합니다. 직접 관리하는 도메인에서 자체 스토리지와 데이터를 사용해 Stoat 인스턴스를 호스팅합니다. 더 넓은 범위에 배포하기 전에 Stoat 스택을 테스트하거나 평가합니다.

self-hosted는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/stoatchat/self-hosted stoat 프로젝트 디렉터리로 이동합니다: cd stoat 도메인을 지정해 설정을 생성합니다: ./generate_config.sh your.domain 인스턴스를 백그라운드에서 시작합니다: docker compose up -d

self-hosted은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/stoatchat/self-hosted