What is FeedLog?
FeedLog is a feedback collection tool. Users submit ideas on public boards and vote on them. You decide what to work on, merge duplicate posts, share planned work on a roadmap, and publish completed work in a changelog.
FeedLog is open source under the MIT license. You can use the hosted service or deploy it on your own infrastructure.
Core concepts
These seven concepts appear throughout the documentation. Read this table before continuing.
| Concept | What it is |
|---|---|
| Board | Where feedback is organized. A new workspace includes four boards: Feature Requests, Bug Report, Improvements, and Other. You can rename or reorder them and create more. |
| Post | A single piece of feedback with a title, a description, and optional attachments. Anyone who can see the board can read it. |
| Vote | One per person per post, and it can be taken back. |
| Status | A post's current stage: Open, Planned, In Progress, or Completed. Changing the status does not notify subscribers. You can send a notification separately when you are ready. |
| Roadmap | A public view of posts grouped by status. It shows Planned, In Progress, and Completed posts; Open posts do not appear. |
| Changelog | A record of completed work published to your users. AI can draft entries from the feedback you closed. |
| Widget | A panel embedded in your product. Users describe a problem in their own words; AI turns it into a post or directs them to your support channel. |
You can start with boards and statuses. Add the roadmap, changelog, and widget when you need them.
Cloud or self-hosted?
Choose a deployment option before configuring FeedLog. Each option has different setup and maintenance requirements.
| Cloud | Self-hosted | |
|---|---|---|
| Who runs it | We do | You do |
| Where your data lives | Our managed Postgres | Your Postgres, your S3 bucket |
| AI features | Included, with no additional configuration | Provide an API key for OpenAI, Azure, a LiteLLM proxy, or a model on your own hardware |
| Custom domain | Set it in your workspace settings | Point your own reverse proxy at the instance |
| Upgrades | Automatic | Pull the new image, run the migrations |
| Cost | Subscription fee | Infrastructure costs |
Both options include the multi-tenant foundation, boards, roadmap, changelog, duplicate detection, and widget. These features are all part of the open-source code. Cloud adds managed hosting, upgrades, and infrastructure operations.
Choose Cloud if
Choose Cloud when you want to launch without managing Postgres, TLS certificates, or email delivery.
Choose self-hosted if
Choose self-hosting when feedback data must remain in your infrastructure, or when you want to connect AI features to a model you control instead of OpenAI.
FeedLog supports Docker, Vercel, and Cloudflare Workers. Self-hosting requires a PostgreSQL 17 or later database with the vector extension installed. Duplicate detection uses this extension.
Where to go next
Continue with the documentation for your deployment option.
- Running on Cloud → start with Creating and managing boards, then read How feedback works. Those two cover most of what you'll do day to day.
- Running it yourself → start with Self-hosting overview. It gets you to a running instance; Configuring external services covers the optional services (login providers, email, storage, and AI) and explains which features are affected if you do not configure them.
To embed FeedLog in another product, follow Install the feedback widget. The guide is self-contained and does not require the rest of this documentation.
Sending this to your own users?
How to give feedback explains submission, voting, comments, and notification emails without including administrator instructions. You can share it in your product or by email without editing it.