설정 파일

릴레이는 시작 디렉토리에서 tapflow.config.json을 읽습니다.

예시

{
  "server": {
    "port": 4000,
    "dataDir": ".tapflow",
    "jwtSecret": "CHANGE_THIS_TO_A_LONG_RANDOM_SECRET"
  },
  "smtp": {
    "host": "smtp.example.com",
    "port": 587,
    "secure": false,
    "user": "relay@example.com",
    "pass": "password",
    "from": "tapflow <noreply@example.com>"
  }
}

설정 템플릿은 tapflow.config.example.json에 포함되어 있습니다.

환경변수 오버라이드

환경변수는 항상 설정 파일보다 우선합니다. 서버 환경이나 CI에서 유용합니다.

환경변수	Config 키	기본값	설명
TAPFLOW_PORT	server.port	4000	서버 포트
JWT_SECRET	server.jwtSecret	(개발용 기본값)	JWT 서명 키
TAPFLOW_DATA_DIR	server.dataDir	.tapflow	DB·업로드 디렉토리 (상대 경로 지원)
SMTP_HOST	smtp.host	``	SMTP 호스트
SMTP_PORT	smtp.port	587	SMTP 포트
SMTP_SECURE	smtp.secure	false	TLS 사용 여부 (true 문자열로 설정)
SMTP_USER	smtp.user	``	SMTP 사용자명
SMTP_PASS	smtp.pass	``	SMTP 비밀번호
SMTP_FROM	smtp.from	tapflow <noreply@tapflow.local>	이메일 발신자

JWT_SECRET은 반드시 교체하세요

JWT_SECRET을 설정하지 않으면 개발용 기본값이 사용됩니다. 프로덕션에서 기본값을 사용하면 누구나 유효한 인증 토큰을 위조할 수 있습니다.

안전한 값을 생성하려면:

openssl rand -hex 32

데이터 디렉토리

릴레이는 모든 데이터를 .tapflow/에 저장합니다 (기본값):

.tapflow/
  db.sqlite         ← SQLite 데이터베이스
  uploads/
    builds/         ← .app.zip 및 .apk 파일
    avatars/
    comments/

위치를 변경하려면 TAPFLOW_DATA_DIR 환경변수 또는 server.dataDir 설정을 사용합니다. 이 디렉토리를 백업하면 모든 데이터가 보존됩니다.

SMTP 설정

SMTP가 설정되지 않으면 초대 이메일과 비밀번호 재설정 이메일이 발송되지 않습니다. 이 경우 Admin이 초대 링크를 직접 복사해 공유할 수 있습니다.

팀 초대에 이메일을 사용하려면 smtp.host와 smtp.user, smtp.pass를 설정합니다.