QueryPie ACP Community Edition

1 🧭 시작하기 전에
2 🖥️ 권장 서버 사양
3 🐳 설치 방법
- 3.1 1. 터미널에서 명령 실행
- 3.2 2. 설치 중 라이선스 발급 받기
- 3.3 3. 설치 후 접속
- 3.4 4. 라이선스 등록
- 3.5 5. 로그인
- 3.6 6. 설치 완료 🎉
4 💬 지원 및 문의

🧭 시작하기 전에

QueryPie Community Edition은 QueryPie Enterprise에서 제공되는 핵심 기능을 체험할 수 있도록 합니다.

Database Access Controller
System Access Controller
Kubernetes Access Controller
MCP(Model Context Protocol) Access Controller

단, Community Edition은 최대 5명의 사용자 활성화를 지원합니다. (5명 이상을 등록해야 하는 경우, Standard Edition 또는 Enterprise Edition 업그레이드를 고려해 주세요.)

QueryPie는 일반적인 웹 애플리케이션 형태로 실행되며, 프록시 기반 네트워크 서버 기능도 포함하고 있습니다.

🖥️ 권장 서버 사양

QueryPie Community Edition의 원활한 설치 및 운영을 위해 다음과 같은 시스템 환경을 권장합니다.

유형	사양

유형	사양
기본 사양	Hardware : AMD64 Architecture, CPU 4 vCPUs, Memory 16 GiB, Disk 100 GiB+ AWS EC2 : m6i.xlarge, m7i.xlarge GCP Compute Engine : c4-standard-4, n4-standard-4 (or AMD64 architecture -standard-4 models)
시험 사용	Hardware: ARM64 Architecture, 4 vCPUs, Memory 16 GiB, Disk 30 GiB+ AWS EC2 : t4g.xlarge, m7g.xlarge OS: Linux or macOS with Docker
다중 사용자를 위한 프로덕션 환경 권장 사양	Hardware: AMD64 Architecture, 8 vCPUs, Memory 32 GiB, Disk 100 GiB+ AWS EC2 : m6i.2xlarge, m7i.2xlarge GCP Compute Engine : c4-standard-8, n4-standard-8 (or AMD64 architecture -standard-8 models)
OS	Linux with Docker or Podman

ARM64 Architecture CPU 환경 또는 macOS 환경은 개발자를 위한 시험사용, 테스트 용도로 권장합니다.

자세한 요구사항은 아래 문서를 참고하세요: 설치 전 준비사항

🐳 설치 방법

1. 터미널에서 명령 실행

Linux 서버의 터미널에 접속한 후, 홈 디렉터리에서 다음 명령어를 실행하세요:

bash <(curl -s https://dl.querypie.com/setup.v2.sh)

⏱️ 설치는 보통 7~10분 정도 소요됩니다.

설치가 시작된 화면

설치가 완료된 화면

2. 설치 중 라이선스 발급 받기

QueryPie Community Edition은 라이선스 등록이 필요합니다. 설치가 진행되는 동안 라이선스 신청서를 제출하면, 신청 시 입력한 이메일 주소로 .crt 텍스트 파일이 발송됩니다.

3. 설치 후 접속

설치가 완료되면 브라우저에서 다음 주소로 접속하세요:

http://<server IP address>:8000
or 
https://<server IP address>:8443

QueryPie가 설치된 Linux 서버의 IP 주소는 사용자 PC에서 접근 가능해야 합니다.

4. 라이선스 등록

이메일로 받은 .crt 파일을 업로드하거나, PEM 형식의 텍스트 내용을 복사해 붙여넣으세요.

PEM 형식 라이선스 입력 화면

라이선스 안내

QueryPie를 사용하려면 설치 후 반드시 유효한 라이선스를 등록해야 합니다.
라이선스는 .crt 확장자의 텍스트 파일로 제공됩니다.
라이선스는 신청 시 입력한 이메일 주소로 발송됩니다.
각 라이선스는 발급일로부터 1년간 유효합니다.
라이선스는 신청자 본인에게 발급되며, 제3자에게 양도할 수 없습니다.

5. 로그인

기본 계정으로 로그인하세요. 첫 로그인 시 보안을 위해 비밀번호 변경을 요청받습니다. 새로운 비밀번호를 설정한 후 서비스를 사용할 수 있습니다.

ID: qp-admin
Password: querypie

초기 로그인 화면

qp-admin 계정으로 로그인 후 기본 암호를 다른 암호로 변경합니다.

초기 암호 변경 화면

6. 설치 완료 🎉

설치가 성공적으로 완료되었습니다. 환경 설정을 위해 관리자 매뉴얼을 참고해 주세요: 관리자 매뉴얼
관리자 페이지로 이동하기 위해서는 오른쪽 상단의 Go to Admin Page 버튼을 누릅니다.

로그인 후 표시되는 사용자 대시보드

QueryPie ACP Community Edition의 설치 위치

Mac, Linux : 설치 스크립트를 실행한 폴더/querypie/<설치 버전>
- 예시 : /Users/<사용자 계정이름>/querypie/<설치 버전> 또는 /home/<사용자 계정이름>/querypie/<설치 버전>(사용자 홈디렉터리에서 설치스크립트가 수행된 경우)

QueryPie ACP Community Edition의 수동 시작

설치 위치로 이동합니다.
current는 설치 버전 경로의 심볼릭 링크입니다.

cd ~/querypie/current ## This is an example when installed under the home directory.

수동시작 : database 시작 → app 시작의 순서로 시작합니다.

docker compose --profile=database up -d
docker compose --profile=app up -d

정상 기동 확인

docker compose --profile=app exec app readyz

정상적으로 기동이 되었다면 아래와 유사한 화면이 출력됩니다.

정상적으로 시작된 경우

QueryPie ACP Community Edition의 수동 중지

설치 위치로 이동합니다.
current는 설치 버전 경로의 심볼릭 링크입니다.

cd ~/querypie/current ## This is an example when installed under the home directory.

수동 중지 : app 중지 → database 중지의 순서로 중지합니다.

docker compose --profile=app down
docker compose --profile=database down

정상 종료 확인

docker compose ps

중지 방법의 선별적 적용

docker compose --profile=app down
docker compose --profile=database down

위 와 같이 down 을 사용하면 컨테이너, 네트워크가 삭제 후 새로 생성됩니다. (새 ID)
따라서, 반드시 삭제 및 새로 생성할 필요가 없는 경우 down 대신 stop을 사용합니다.

docker compose --profile=app stop
docker compose --profile=database stop

💬 지원 및 문의

QueryPie Community 설치 및 사용 중 궁금한 점이 있으면 GitHub Discussion에서 직접 문의할 수 있습니다. 많은 이용과 관심을 부탁드립니다.