Sign inSign up

pletorco/konduo-backend

By pletorco

Updated 2 days ago

Konduo CE backend API server with plugin runtime, RBAC, alerts, metrics, and PostgreSQL.

Image
Monitoring & observability
0

6.6K

pletorco/konduo-backend repository overview

Konduo Community Edition

Konduo Community Edition is an integrated operations and monitoring platform.

It provides a Go-based backend and a Svelte-based web UI for managing monitoring targets, metric-based operational views, dashboards, alert rules, and alert delivery channels in one workflow.

This image is part of the Konduo CE container stack.

Container Stack

Konduo CE is intended to be used with:

  • pletorco/konduo-backend
  • pletorco/konduo-frontend
  • PostgreSQL
  • Prometheus

Optional:

  • pletorco/konduo-manual-ce

Docker Compose Quick Start

For a local first run, create a working directory:

mkdir -p konduo-quickstart/prometheus
cd konduo-quickstart

Prepare your .env, compose.yml, and Prometheus configuration using the full Docker Compose guide linked below.

Then start the stack:

docker compose --env-file .env -f compose.yml pull
docker compose --env-file .env -f compose.yml up -d
docker compose --env-file .env -f compose.yml ps

Open Konduo in your browser:

http://localhost:5173

If the optional manual container is enabled in your Compose setup, the Community manual is served together with the frontend under:

http://localhost:5173/manual/

Configuration Highlights

Important backend configuration includes:

VariableDescription
DB_TYPEDatabase type. Use postgres.
DB_HOSTPostgreSQL host.
DB_PORTPostgreSQL port.
DB_NAMEPostgreSQL database name.
DB_USERPostgreSQL user.
DB_PASSWORDPostgreSQL password.
JWT_SECRETSecret used for JWT signing.
KONDUO_SECRET_KEYStable secret key used by Konduo for stored secrets and credentials.

Important frontend configuration includes:

VariableDescription
BACKEND_UPSTREAMBackend upstream address used by the frontend container.
MANUAL_UPSTREAMOptional manual upstream address used when serving the Konduo manual through the frontend container.

Images

Required:

  • Backend: pletorco/konduo-backend
  • Frontend: pletorco/konduo-frontend

Optional:

  • Manual: pletorco/konduo-manual-ce

Operational Notes

For local validation, latest is convenient.

For repeatable validation, pre-production, or production-like environments:

  • Use version tags or digest pinning instead of latest.
  • Generate stable secrets and keep them across restarts and upgrades.
  • Change all default passwords.
  • Keep PostgreSQL data on a persistent volume.
  • Back up PostgreSQL regularly.
  • Review TLS, firewall rules, network exposure, and reverse proxy settings before exposing Konduo externally.

Full Guide

The full Docker Compose guide covers .env configuration, PostgreSQL, Prometheus, first login, validation steps, optional manual access, and basic production considerations:

Run Konduo Community with Docker Compose in 10 Minutes

Tag summary

Content type

Image

Digest

sha256:b61cd424d

Size

145.2 MB

Last updated

2 days ago

docker pull pletorco/konduo-backend