{"id":28455694,"url":"https://github.com/questdb/questdb-quickstart","last_synced_at":"2025-07-06T13:35:52.261Z","repository":{"id":66588529,"uuid":"558979095","full_name":"questdb/questdb-quickstart","owner":"questdb","description":"quickstart to work with questdb","archived":false,"fork":false,"pushed_at":"2024-08-01T11:18:43.000Z","size":2066,"stargazers_count":22,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-06T22:11:16.984Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/questdb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-28T18:28:10.000Z","updated_at":"2025-06-05T00:40:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"fc33941a-281e-43a8-87e9-900d870ff9a2","html_url":"https://github.com/questdb/questdb-quickstart","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/questdb/questdb-quickstart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questdb%2Fquestdb-quickstart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questdb%2Fquestdb-quickstart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questdb%2Fquestdb-quickstart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questdb%2Fquestdb-quickstart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/questdb","download_url":"https://codeload.github.com/questdb/questdb-quickstart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questdb%2Fquestdb-quickstart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262177720,"owners_count":23270924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-06T22:10:25.850Z","updated_at":"2025-07-06T13:35:52.256Z","avatar_url":"https://github.com/questdb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# questdb-quickstart\n\nQuestDB is an Apache 2.0 licensed time-series database for high throughput ingestion and fast SQL queries with operational simplicity. To learn more about QuestDB visit https://questdb.io\n\n This is a quickstart covering:\n\n* Getting started with QuestDB on docker\n* Loading data using a CSV\n* Using the web console for interactive queries\n* Ingesting real-time data using the official clients in Go, Java, or Python\n* Real-time dashboards with Grafana and QuestDB using the PostgreSQL connector\n\nFor a video walkthrough, please visit:\n[![For a video walkthrough, please visit](https://img.youtube.com/vi/r8zE1JNuqyA/maxresdefault.jpg)](https://youtu.be/r8zE1JNuqyA)\n\n# Deploying the demo\n\nThis quickstart requires starting or deploying QuestDB, Grafana, and some ingestion scripts. You have three ways of setting this up:\n\n* Fully managed cloud-based installation (requires creating a free account on gitpod) using the Gitpod link in the next section. Recommended for quick low-friction demo\n* Local installation using docker-compose. Recommended for quick low-friction demo, as long as you have docker/docker-compose installed locally and are comfortable using them\n* Local installation using docker but doing step-by-step. Recommended to learn more about the details and how everything fits together\n\n\nAfter you install with your preferred method (instructions below) you can proceed to [loading and querying data](./loading_and_querying_data.md)\n\n## Fully managed deployment using Gitpod\n\nWhen you click the button below, gitpod will provision an environment with questdb, a python script generating demo data,\nand a grafana dashboard for visualisation. On finishing (typically about one minute), gitpod will try to open two new\ntabs, one with the grafana dashboard, one with the QuestDB web interface. When opening the grafana dashboard,\nuser is \"demo\" and password is \"quest\".\n\nClick the button below to start a new development environment:\n\n[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/questdb/questdb-quickstart)\n\nNote: If you already have a gitpod account, you will need to log in when launching the deployment. If you don't have a gitpod\naccount, you can create one for free when launching the deployment. If your browser is blocking pop-ups, you will\nneed to click on the alert icon on the navigation bar to open the two links after the deployment is complete.\n\nIf you want to explore loading batch data using the web interface or the REST API, please visit [loading and querying data](./loading_and_querying_data.md).\nNote you will need to use the endpoint provided by gitpod, rather than the default http://localhost:9000.\n\n## Docker-compose local deployment\n\nDocker compose will provision an environment with questdb, a python script generating demo data,\nand a grafana dashboard for visualisation. The whole process will take about 2-3 minutes, depending on yout internet speed\ndownloading the container images, and how quick your machine can build a python-based docker image.\n\n```\ngit clone https://github.com/questdb/questdb-quickstart.git\ncd questdb-quickstart\ndocker-compose up\n```\n\nThe grafana web interface will be available at http://localhost:3000/d/qdb-ilp-demo/device-data-questdb-demo?orgId=1\u0026refresh=5s.\nUser is \"demo\" and password is \"quest\".\n\nThe QuestDB console is available at http://localhost:9000\n\nIf you want to explore loading batch data using the web interface or the REST API, please visit [loading and querying data](./loading_and_querying_data.md).\n\nStop the demo via:\n\n```\ndocker-compose down\n```\n\n## Local docker based deployment\n\nThe local deployment has four steps: starting QuestDB, loading batch data, ingesting real-time data, and creating dashboards with Grafana.\n\n### Starting QuestDB\n\nThere are [many ways to install QuestDB](https://questdb.io/docs/get-started/docker/), but I am choosing docker for portability. Note I won't be using a docker volume and the data will be ephemeral. Check the QuestDB docks to see how to start with a persistent directory.\n\n```docker run --add-host=host.docker.internal:host-gateway -p 9000:9000 -p 9009:9009 -p 8812:8812 -p 9003:9003 questdb/questdb:latest```\n\nPort 9000 serves the web console, port 9009 is for streaming ingestion, port 8812 is for PostgreSQL-protocol reads or writes, port 9003 is a monitoring/metrics endpoint.\n\n### Importing batch data\n\nIf you want to explore loading batch data using the web interface or the REST API, please visit [loading and querying data](./loading_and_querying_data.md).\nIf you are only interested in streaming data you can skip this step.\n\n### Ingesting real-time data using the official clients in Go, Java, or Python\n\nWe will generate simulated IoT data and will use the QuestDB client libraries to ingest in real-time into questdb.\nDepending on your language of choice, follow the instructions at\n* https://github.com/javier/questdb-quickstart/tree/main/ingestion/go\n* https://github.com/javier/questdb-quickstart/tree/main/ingestion/java\n* https://github.com/javier/questdb-quickstart/tree/main/ingestion/python\n\n### Real-time dashboards with Grafana and QuestDB using the PostgreSQL connector\n\nPlease follow the instructions at https://github.com/javier/questdb-quickstart/tree/main/dashboard/grafana\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestdb%2Fquestdb-quickstart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquestdb%2Fquestdb-quickstart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestdb%2Fquestdb-quickstart/lists"}