Skip to content

Self-hosted

Run Quackback on your own servers

A self-hosted feedback tool and help desk with every feature: feedback boards, a roadmap and changelog, a support inbox, a help center and a status page. Free under AGPL-3.0. You run the servers, backups and upgrades.

Run it yourself, or let us

  • Self-host free, every feature
  • Unlimited seats, no license key
  • Or use Cloud: free plan, no card

The widget your customers see inside your app.

Your team’s viewYour customers’ view

Example data. What follows is an interactive demo of a made-up workspace called Acme. Its customers, posts, votes and changelog entries are examples, not Quackback's own.

Feedback
Review
Status
Board
Tags

Up and running in minutes

Every release ships as a Docker image for x86 and ARM servers. Docker Compose starts the whole stack on one host.

One file, one command

Clone the repository, set your domain and three secrets, and start the stack. Migrations run on every start, so an upgrade is a pull and a restart.

Deploy with Docker
Terminal
# Clone the repository
git clone https://github.com/QuackbackIO/quackback.git
cd quackback

# Fill in every value: BASE_URL and three secrets
cp .env.prod.example .env
openssl rand -base64 32   # SECRET_KEY
openssl rand -hex 24      # POSTGRES_PASSWORD
openssl rand -hex 24      # MINIO_ROOT_PASSWORD

# Start the app, Postgres and storage
docker compose -f docker-compose.prod.yml up -d

Other ways to deploy

Your own Postgres and S3Run the image against a managed database and bucket.
RailwayThe fastest start, with no server to manage.
Without DockerInstall and run it with Bun.
A config fileKeep settings in a YAML file you can version.
Multiple replicasSplit web and background work as you grow.
Quick startThe shortest path to a running install.

What it needs

Modest hardware and one database. Postgres holds your data, the job queue and realtime events, so there's no Redis to run.

Full system requirements
Server
1 CPU and 1 GB RAM minimum; 2 CPUs and 2 GB recommended
Disk
10 GB minimum; 20 GB or more recommended
Database
PostgreSQL 14+ with the pgvector and pg_trgm extensions
File storage
Any S3-compatible bucket, or the one bundled with Docker Compose
Runtime
Docker 20.10+ with Compose v2, or Bun 1.4+ without Docker
Email
SMTP, Amazon SES or Resend
Inbound email (optional)
A Resend inbound domain or an IMAP mailbox, to receive customer email in the inbox
AI (optional)
Any OpenAI-compatible provider
Network
HTTPS through a reverse proxy to port 3000

What you take on

Self-hosting swaps a monthly bill for operational work. This is what that work includes.

Servers and uptimeHosting, monitoring and being on call. There's no SLA on your own install.
BackupsSchedule backups of Postgres and your file storage, keep copies off-site and test restores. Uploads live in storage, so a database backup alone misses them.
UpgradesRead each release's notes, then pull the new image and restart.
SecurityTLS, firewall rules, secrets and patching the host.
Email deliveryConnect SMTP, Amazon SES or Resend for sign-in codes and notifications.
Inbound emailTo receive customer email in the inbox, set up an inbound domain through Resend or point Quackback at an IMAP mailbox. It's off until you do.
Integrations and sign-inRegister your own app with Slack, Linear, GitHub and other providers once. On Cloud we provide them.
An AI providerQuackback AI needs an OpenAI-compatible provider you set up and pay for.

Self-hosted or Cloud

Both run the same code. The difference is who runs it. Most teams choose Cloud, and self-host when data has to stay on their own infrastructure.

Self-hosted Quackback compared with Quackback Cloud
Self-hostedCloud
PriceFree, plus your hostingFree plan; paid from $29/mo
FeaturesEvery featureBy plan
SeatsUnlimited1 to unlimited, by plan
Servers, backups, upgradesYou run themWe run them
Quackback AIYour own providerIncluded, more on higher plans
SupportCommunity on GitHubEmail on paid plans
Uptime SLANone99.9% on Enterprise
Powered by Quackback badgeAlways shownRemovable add-on
View on GitHubStart free trial

Common questions

Is self-hosted Quackback really free?

Yes. Quackback is open source under AGPL-3.0. The self-hosted edition has every feature and unlimited seats, with no license key. You pay for your own servers, storage and AI provider.

What do I need to run it?

A server with at least 1 CPU and 1 GB of RAM (2 of each recommended), PostgreSQL 14 or newer with the pgvector and pg_trgm extensions, and S3-compatible storage for uploads. Docker Compose sets up the app, Postgres and storage for you. No Redis is needed.

How do upgrades work?

Pull the new image and restart. Database migrations run automatically on startup. In production, pin a release tag rather than latest, read the release notes first, and back up Postgres and your file storage before you upgrade.

Can I use Quackback AI when I self-host?

Yes, once you connect an OpenAI-compatible AI provider with your own account and key. You pay that provider directly. Without one, everything except the AI features works as normal.

Does self-hosted Quackback send telemetry?

It sends one anonymous snapshot a day: the version, which features are switched on and usage counts in broad bands. It never includes names, emails, URLs or content. Set DISABLE_TELEMETRY=true and nothing is sent.

Who is responsible for security and compliance?

You are. On your own servers, TLS, firewalls, secrets, patching, backups and any compliance work such as GDPR or SOC 2 depend on how you run it. Quackback is provided under AGPL-3.0, without warranty.

Can I import feedback from another tool?

Yes. Import posts from a CSV file in the app, or use the command-line importer to bring in posts, comments, votes and notes through the REST API.

When is Cloud the better choice?

When you'd rather not run servers. Cloud is the same product, kept up to date, backed up and monitored for you, with email support on paid plans. It has a Free plan, and paid plans start at $29 a month billed yearly.

Have another question? Talk to the team.

Run it yourself, or let us run it