Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

QueryPie ACP Community Edition

What is QueryPie Access Control Platform (ACP)?

QueryPie Access Control Platform (ACP) is an integrated access control solution that provides DAC, SAC, KAC, WAC, and MCP Access Control in a single unified platform. It covers both cloud and on-premises environments, providing unified management of all access from databases to systems, Kubernetes, and web applications.

Access Control Components

It enhances enterprise data security through RBAC/ABAC-based dynamic access control, web SQL editor, real-time auditing, and anomaly detection alerts. With Docker-based easy installation and web-based interface, it provides a hybrid solution that combines the convenience of SaaS with the powerful security of on-premises.

🧭 Before You Start

QueryPie ACP Community Edition includes DAC, SAC, KAC, and MCP Access Control for up to 5 active users. WAC is available with the Enterprise Edition. See the ACP plans for an edition comparison and the Community Edition guide for current installation guidance.

QueryPie ACP runs as a typical web application and also includes proxy-based network server functionality.


🖥️ Server Requirements

Basic Specifications

  • CPU: 4 vCPUs (AMD64 Architecture)
  • Memory: 16 GiB RAM
  • Storage: 100 GB+ disk space
  • OS: Linux with Docker or Podman

Cloud Instances:

  • AWS EC2: m6i.xlarge or m7i.xlarge
  • GCP Compute Engine: c4-standard-4, n4-standard-4 (or any AMD64 -standard-4 models)

Trial Use

For developers testing and trial purposes (ARM64 supported):

  • CPU: 4 vCPUs (ARM64 Architecture)
  • Memory: 16 GiB RAM
  • Storage: 30 GB+ disk space
  • OS: Linux or macOS with Docker

Cloud Instances:

  • AWS EC2: t4g.xlarge or m7g.xlarge

Recommended for Production

For multi-user production environments:

  • CPU: 8 vCPUs (AMD64 Architecture)
  • Memory: 32 GiB RAM
  • Storage: 100 GB+ disk space
  • OS: Linux with Docker or Podman

Cloud Instances:

  • AWS EC2: m6i.2xlarge or m7i.2xlarge
  • GCP Compute Engine: c4-standard-8, n4-standard-8 (or any AMD64 -standard-8 models)

Note: ARM64 Architecture CPU environments or macOS environments are recommended for trial use and testing purposes for developers.

📄 For detailed requirements, see: Prerequisites


🚀 Quick Installation

QueryPie installation is automated using Docker. Follow these simple steps:

Step 1: Run Installation Command

Open your Linux server terminal and run this single command from your home directory:

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

⏱️ Installation time: Typically 7-10 minutes

Installation started
Installation in progress

Step 2: Request License (During Installation)

While installation is running, apply for your free license:

  1. Fill out the license application form
  2. A .crt license file will be sent to your email

Step 3: Access QueryPie

Once installation completes, open QueryPie in your browser:

http://<your-server-ip>:8000
or  
https://<your-server-ip>:8443

Note: Make sure your server IP is accessible from your computer

Installation complete
Installation completed successfully

Step 4: Upload License

Upload your .crt license file or copy-paste the PEM content:

License upload
Enter license in PEM format

Step 5: First Login

Use the default admin credentials:

  • Username: qp-admin
  • Password: querypie

🔒 You'll be prompted to change the password on first login for security

Login screen
Initial login screen

Step 6: Setup Complete! 🎉

Congratulations! QueryPie is now ready to use.

Welcome screen
Welcome to QueryPie!

Next Steps:

  • Check out the Administrator Manual for environment setup
  • Click the Go to Admin Page button in the top right corner to navigate to the administrator page
  • Start configuring your database connections
  • Invite team members (up to 5 users)

📁 Installation Location & Manual Operations

Installation Location:

  • Mac, Linux: <folder where the installation script was executed>/querypie/<version>
  • Example: /Users/<username>/querypie/<version> or /home/<username>/querypie/<version>
  • The current symbolic link points to the installed version directory

Manual Start:

cd ~/querypie/current
docker compose --profile=database up -d
docker compose --profile=app up -d

Verify Normal Startup:

docker compose --profile=app exec app readyz

Manual Stop:

cd ~/querypie/current
docker compose --profile=app down
docker compose --profile=database down

Verify Normal Shutdown:

docker compose ps

🔑 License Information

  • Requirement: Valid license required after installation
  • Format: Text file with .crt extension (PEM format)
  • Delivery: Sent to your email address from application form
  • Duration: Valid for one year from issue date
  • Usage: Personal license, non-transferable

💬 Support & Community

Join our community for help and discussions:

🔗 GitHub Discussions

Get support, ask questions, and share insights with other QueryPie users!

About

Unified access control platform for databases, servers & Kubernetes with zero-trust security.

Resources

Stars

19 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors