# Feeblo Docs

> Docs for Feeblo, the open-source customer feedback platform. Embed the widget SDK, call the HTTP API, receive webhooks, and self-host your own instance.

## Docs

- [Introduction](https://docs.feeblo.com/): Feeblo is an open-source customer feedback platform. Collect feature requests, share roadmaps, publish changelogs, and embed a feedback widget in your app.

## Developers

- [Quickstart](https://docs.feeblo.com/developers/quickstart): Install the Feeblo widget SDK and open your first feedback widget in a few minutes.
- [Identifying users](https://docs.feeblo.com/developers/identity): The identity object for Feeblo.identify: fields, companies, and custom attributes.
- [Widget SSO](https://docs.feeblo.com/developers/widget-sso): Sign identity tokens on your server and sign users into your public board without a second login.
- [Configuration](https://docs.feeblo.com/developers/configuration): Every Feeblo.init option, the three widget modes, launcher placement, and how each prop behaves in React.
- [Triggers and events](https://docs.feeblo.com/developers/triggers-and-events): Open the Feeblo widget with markup attributes or code, then subscribe to widget events in vanilla JS or React.
- [Widget HTTP API](https://docs.feeblo.com/developers/api): The four public HTTP endpoints behind the feedback widget, with request and response shapes, the auth model, error codes, and rate limits.
- [Webhooks](https://docs.feeblo.com/developers/webhooks): Receive feedback.post.created and feedback.post.status_changed events at your HTTPS endpoint, verify Standard Webhooks signatures, and handle retries.

## Self-hosting

- [Self-hosting Overview](https://docs.feeblo.com/self-hosting/overview): What running Feeblo yourself involves: the four services, what they require, and how traffic flows between them.
- [Deploy with Docker](https://docs.feeblo.com/self-hosting/docker): Run the full Feeblo stack with docker compose: what each service does, first boot, and the upgrade path.
- [Environment variables](https://docs.feeblo.com/self-hosting/environment): Every environment variable the Feeblo server and dashboard read, grouped by concern with defaults and which ones are required.
- [Database](https://docs.feeblo.com/self-hosting/database): Postgres for Feeblo. The DATABASE_URL shape, compose defaults, and the migration lifecycle from schema change to deployed schema.
- [Email](https://docs.feeblo.com/self-hosting/email): How Feeblo sends mail. The SMTP transport variables, the Amazon SES feedback webhook, and the outbox controls.
- [Media](https://docs.feeblo.com/self-hosting/media): Where Feeblo stores images. S3-compatible buckets, Cloudflare R2 settings, and MinIO for local development.
- [OAuth login](https://docs.feeblo.com/self-hosting/oauth): Register GitHub and Google OAuth apps, set client credentials, and test logins against a local OAuth emulator.
- [Troubleshooting](https://docs.feeblo.com/self-hosting/troubleshooting): Fix the failure modes that hit self-hosted Feeblo deployments, each with a cause you can verify in the source.