Skip to main content

Quick Setup

Prerequisite#

Main requirement:#

Docker needs to be installed for quick setup.

System requirements:#

  • Memory Requirements1:
    • Windows with WSL: 10GB of free memory
    • Mac: 7GB of free memory
    • Linux: 4GB of free memory
  • 5GB of disk space

Kernel Config#

Linux#

Run sudo sysctl -w vm.max_map_count=262144 to ensure ElasticSearch works.

Mac#

Go to the Docker Desktop app -> top right gear icon -> Resources -> Advanced. Make sure your memory limit per app is >= 5GB 2.

Windows#

Please install WSL 2 as instructed here. Now go to Docker Desktop, Settings > General, and check the box "Use the WSL 2 based Engine".

Launch WSL shell and run sudo sysctl -w vm.max_map_count=262144 to ensure ElasticSearch works.

Getting Started#

Open your terminal, and run:

git clone https://github.com/pinterest/querybook.gitcd querybook

Now run the following

make

That's it! ๐ŸŽ‰

You can now access it on http://localhost:10001.

Check out the general configuration guide for more detailed info about what can be configured in the Querybook Admin UI.

If the command did not work, checkout Troubleshoot.


  1. Tested on 16GB/64GB Mac & 32GB Windows/Ubuntu.โ†ฉ
  2. Total container memory usage should not exceed 2GB, this is only needed because Elasticsearch has a high peak memory at the start.โ†ฉ
Last updated on by czgu