컨텐츠로 건너뛰기

환경 변수

Hollo는 환경 변수를 통해 여러 가지 설정을 할 수 있습니다. 환경 변수는 프로젝트 최상위 디렉터리에 .env 파일을 만들거나, Docker의 -e/--env 옵션을 쓰거나, Railway의 environment variables 메뉴에서 설정할 수 있습니다.

PORT 선택 Railway에서는 안 쓰임

서버가 수신할 포트 번호. 기본값은 3000입니다.

DATABASE_URL Railway에서는 안 쓰임

PostgreSQL 데이터베이스의 URL. 예: postgresql://hollo:password@localhost/hollo.

HOME_URL 선택

설정될 경우, 첫 페이지 접속 시 이 URL로 리다이렉트됩니다. 설정되지 않을 경우, 첫 페이지에서 인스턴스 내 계정 목록이 보입니다.

SECRET_KEY Railway에서는 안 쓰임

세션을 보호하기 위한 비밀 키. 다음 명령어로 안전한 무작위 비밀 키를 생성 가능합니다:

openssl rand -hex 32

REMOTE_ACTOR_FETCH_POSTS 선택

원격 액터와 처음으로 조우하게 되었을 때 가져올 최신 공개 게시물의 수.

기본값은 10입니다.

LOG_LEVEL 선택

애플리케이션의 로그 레벨. debug, info, warning, error, fatal 중 택일.

기본값은 info입니다.

LOG_QUERY 선택

SQL 쿼리를 로그에 남기려면 true로 설정하세요.

기본값은 false입니다.

BEHIND_PROXY 선택 Railway에서는 안 쓰임

Hollo가 리버스 프록시 뒤에 있는 경우 true로 설정하세요. Hollo가 L7 로드 밸런서 뒤에 위치할 경우 (일반적으로 그래야 합니다), 이 옵션을 켜세요.

기본적으로는 꺼져 있습니다.

ALLOW_PRIVATE_ADDRESS 선택

이 옵션을 true로 설정하면 서버 측 요청 위조(SSRF) 공격 방지를 풉니다.

로컬 네트워크에서 테스트할 때 이 옵션을 켜야 할 수 있습니다.

기본적으로는 꺼져 있습니다.

S3_REGION 선택

S3 호환 오브젝트 스토리지의 지역. 예: us-east-1. 몇몇 AWS가 아닌 S3 호환 서비스에서는 이 값이 필요 없을 수 있습니다.

기본값은 auto입니다.

S3_BUCKET

S3 호환 오브젝트 스토리지의 버킷 이름. 예: hollo.

S3_URL_BASE

S3 호환 오브젝트 스토리지의 공개 URL 베이스. 예: https://hollo.s3.us-east-1.amazonaws.com.

S3_ENDPOINT_URL

S3 호환 오브젝트 스토리지의 엔드포인트 URL. 예: https://s3.us-east-1.amazonaws.com.

S3_FORCE_PATH_STYLE

S3 호환 오브젝트 스토리지에 대해 경로 스타일 URL을 강제할지 여부 (true 혹은 false). AWS가 아닌 S3 호환 서비스에서 유용합니다. 기본적으로는 꺼져 있습니다.

AWS_ACCESS_KEY_ID

S3 호환 오브젝트 스토리지 액세스 키.

AWS_SECRET_ACCESS_KEY

S3 호환 오브젝트 스토리지 비밀 키.