Skip to content

webhookdb/webhookdb

Repository files navigation

Latest Release Gem Version Build Tests Coverage Docs

WebhookDB

Replicate any API to your database with WebhookDB.

WebhookDB handles webhooks and intelligently polls APIs to provide a normalized, schematized, relational copy of API data.

No new APIs to learn -- just an easy-to-use CLI to set up integrations, and then you get a database connection string to access your data. WebhookDB keeps everything up to date, automatically.

WebhookDB is designed to be easily self-hosted (seriously, you can even deploy to Heroku within seconds), or used through WebhookDB Cloud.

Explore the extensive documentation at https://docs.webhookdb.com.

Quick Start

The easiest way to get started is to use the Docker Compose file, which uses the latest webhookdb image and starts up dependencies.

$ docker compose -f docker/docker-compose-demo.yml up 

Then go to http://localhost:18101/terminal, and run:

> webhookdb auth login

The demo Docker Compose file mode will automatically set up some datasets you can browse.

To replicate API data, see what is available with webhookdb services list, and set up a replicator with webhookdb integrations create.

> webhookdb services list
> webhookdb integrations create <service name>

Documentation

Visit https://docs.webhookdb.com to see the docs.

Admin

The server comes with an admin interface at /admin. Go to http://localhost:18101/admin to view it.

Deployment

WebhookDB is designed to be easy to deploy. You just need a way to run a container, some configuration, a Postgres database, and Redis.

To build a configuration file, and deploy directly to Platform-as-a-Service platforms like Heroku, visit https://webhookdb.com/deploy-builder.

License

Licensed under Apache 2.0

Copyright 2020, Lithic Technology