Access
- 브라우저에서 열기:
https://<SERVER_IP> - SSL 경고를 수락하세요 (자체 서명 인증서).
- 웹 인터페이스에서 새 계정을 만드세요.
- 처음 생성된 계정이 관리자 계정이 됩니다.
설정
환경 변수 저장 위치: /root/karakeep/.env
Edit .env or docker-compose.yml to apply changes:
docker compose -f /root/karakeep/docker-compose.yml up -d
공개 회원가입 비활성화 (선택 사항)
Edit .env and modify DISABLE_SIGNUPS:
DISABLE_SIGNUPS=true
Apply changes:
docker compose -f /root/karakeep/docker-compose.yml up -d
AI 기능 활성화 (선택 사항)
Edit /root/karakeep/docker-compose.yml under the web service:
environment:
# OPENAI_API_KEY: "your_openai_api_key_here"
해당 줄의 주석을 해제하고 OpenAI API 키를 입력하세요:
environment:
OPENAI_API_KEY: "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
Apply changes:
docker compose -f /root/karakeep/docker-compose.yml up -d
주요 파일 및 디렉터리
- Application directory:
/root/karakeep - Docker Compose 파일:
/root/karakeep/docker-compose.yml - Environment file:
/root/karakeep/.env - KaraKeep data:
/var/lib/docker/volumes/karakeep_data/_data - Meilisearch data:
/var/lib/docker/volumes/karakeep_meilisearch/_data - Nginx configuration:
/etc/nginx/sites-available/karakeep - SSL certificates:
/etc/nginx/ssl/
도메인으로 SSL 활성화 (선택 사항)
1. 도메인을 서버 IP로 연결합니다.
2. Edit the /root/karakeep/docker-compose.yml 도메인 이름을 설정하는 파일: NEXTAUTH_URL=https://your.domain.com
3. 서비스 재생성:
cd /root/karakeep/
docker compose up -d
4. Nginx 설정 파일을 열고 다음 두 항목을 모두 교체하세요 server_name <IP>; 을 실제 도메인으로 교체합니다 (<your-domain>) HTTP (포트 80) 및 HTTPS (포트 443) 블록 모두에 적용합니다:
vim /etc/nginx/sites-available/karakeep
5. Install Certbot:
apt install -y certbot python3-certbot-nginx
6. 다음 명령어를 실행하여 유효한 Let's Encrypt 인증서를 발급받으세요:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
7. Nginx 설정(TLS 섹션)에서 SSL 경로를 교체합니다:
vim /etc/nginx/sites-available/karakeep
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
8. 변경 사항을 적용하려면 Nginx를 재시작합니다:
systemctl restart nginx
9. 브라우저를 열고 다음 주소로 접속하세요: https://yourdomain.com
