# knadh/listmonk

> listmonk is a standalone, self-hosted newsletter and mailing list manager for sending email to subscribers. It is packed into a single binary and uses PostgreSQL as its data store. The backend is written in Go and the web interface is built with Vue and Buefy.

Source: https://github.com/knadh/listmonk
Indexed: commit ef0a758 on 2026-06-30 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: Go
- Stars: 24,305 at index time
- License: AGPL-3.0
- Code health: 7.5/10, Good
- Last commit: 2026-06-26

## Install

From the README: https://github.com/knadh/listmonk#installation

Start the sample services in the background with Docker Compose after downloading the sample docker-compose.yml file.
    docker compose up -d

## How it works

The entry point is cmd/main.go, which starts the listmonk binary. The cmd directory holds the command code, and cmd/handlers.go and cmd/init.go are among the files that change most often. The internal directory contains the server-side logic, including internal/migrations/v6.2.0.go, a database migration file. The queries and models directories hold the database queries and data models. The frontend directory contains the web dashboard, built with Vue and Buefy. The binary stores its data in PostgreSQL and serves the dashboard and API responses.

- cmd/main.go: entry point
- frontend/cypress/plugins/index.js: entry point
- frontend/email-builder/src/App/InspectorDrawer/ConfigurationPanel/index.tsx: entry point
- frontend/email-builder/src/App/InspectorDrawer/ConfigurationPanel/input-panels/helpers/inputs/ColorInput/index.tsx: entry point
- frontend/email-builder/src/App/InspectorDrawer/index.tsx: entry point
Modules: frontend, internal, cmd, root, .github, queries, models, dev. 238 files, 28,165 lines, 1,247 symbols.

## Code health

- Score: 7.5/10 (Good)
- Rank: #113 of 4,000+ indexed repos
- Hotspots: cmd/handlers.go, cmd/init.go, cmd/bounce.go, cmd/settings.go, internal/migrations/v6.2.0.go
- Lowest file: internal/core/subscribers.go
- Dead code: 29 findings

## Maintenance

- Last commit 2026-06-26
- bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/knadh/listmonk/security

## More

- Page: https://repowise.dev/repo/knadh/listmonk
- Ask this codebase: https://repowise.dev/repo/knadh/listmonk/chat
- Docs: https://repowise.dev/repo/knadh/listmonk/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/knadh/listmonk
