selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Convoy logo

Self-host Convoy

v26.9.5

Webhooks gateway for reliable event delivery at the edge

ReleaseOpen CoreElastic-2.0
curl -fsSL https://getconvoy.io/install | bash
Updated3 days ago
LanguageGo
Setup difficultyModerate
Stars
2 891
Ports
5005 (HTTP port of the Convoy server component), 5006 (Port of the worker server component), 5008 (Port the agent server runs on), 5009 (Port of the ingest server)
Requires
PostgreSQL
Docker
getconvoy/convoy
Advanced endpoint management screen of the Convoy dashboardDeveloper experience view with secrets and payload signing

What is Convoy?

Convoy alternatives

Should you self-host Convoy?

Convoy scores 61/100 on selfhost.directory (how scoring works) and ranks #12 of 38 in API Gateway. It has 2 891 GitHub stars, +13 in the last 30 days.

It shipped 30 stable releases in the past year. The latest, v26.9.5, came out on 12 November 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Elastic-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Kong Gateway (82/100, 44 381 stars). It scores higher overall, so compare the two before you pick. See Convoy vs Kong Gateway side by side.

Features

  • Automatic Retries
  • Batch retries
  • Circuit BreakingComparison table shows circuit breaking is included with the Premium license, not Community.
  • Dynamic endpoints
  • Embedded customer-facing dashboardPortal Links are a Premium feature on self-hosted editions.
  • Event filtering
  • Event search
  • Fan-out routing
  • Incoming & outgoing webhooks
  • JS payload transformationListed as a Premium (paid license) feature in self-hosted editions.
  • OAuth2 & mTLS endpoint auth
  • Payload signing & rolling secrets
  • Rate Limiting
  • SDKs
  • Static IP egress

Convoy README

How to install Convoy

Install Convoy with Docker

curl -fsSL https://getconvoy.io/install | bash

Manual install:

# Get the code
$ git clone https://github.com/frain-dev/convoy.git

# Go to the Convoy folder
$ cd convoy

# Start Services
$ docker compose -f configs/local/docker-compose.yml up

Freshly installed instances log in with the default credentials documented by the project (see docs).

How to configure Convoy

  • CONVOY_HOSTlocalhost:5005Public hostname of the instance, used in emails with links.
  • CONVOY_SENTRY_DSNSentry DSN when tracing type is sentry.
  • CONVOY_QUEUE_PROVIDERredisDelivery task-queue backend (Postgres mode is experimental and licensed).

    values: redis, postgres

  • CONVOY_LOGGER_LEVELerrorLogging level.

    values: fatal, error, warn, info, debug

  • PORT5005Port the server component listens on.

Convoy releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How does API versioning work?

The server defaults to the newest version but clients can keep older behaviour by pinning: via api_version in convoy.json, CONVOY_API_VERSION env var, or the X-Convoy-Version request header, with headers taking highest precedence.

What is the difference between an incoming and an outgoing webhooks project?

Incoming projects act as a reliable ingress for webhooks consumed via HTTP source URLs and need no portal; outgoing projects act as an egress for API providers, ingest events through the REST API or PubSub systems, and give each consumer a portal for their logs.

More in API Gateway

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…