# Run Quackback on your own servers

> Quackback is a free, open-source self-hosted feedback tool and help desk: boards, roadmap, changelog, support inbox and help center on your servers.

Source: https://quackback.io/self-hosted

Self-hosted

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.

## 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](https://feedback.quackback.io/hc/en/articles/67-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 S3](https://feedback.quackback.io/hc/en/articles/67-docker)**: Run the image against a managed database and bucket.

**[Railway](https://feedback.quackback.io/hc/en/articles/68-railway)**: The fastest start, with no server to manage.

**[Without Docker](https://feedback.quackback.io/hc/en/articles/69-manual-install)**: Install and run it with Bun.

**[A config file](https://feedback.quackback.io/hc/en/articles/70-config-file)**: Keep settings in a YAML file you can version.

**[Multiple replicas](https://feedback.quackback.io/hc/en/articles/129-scaling)**: Split web and background work as you grow.

**[Quick start](https://feedback.quackback.io/hc/en/articles/65-local-quick-start)**: The 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](https://feedback.quackback.io/hc/en/articles/66-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 uptime**: Hosting, monitoring and being on call. There's no SLA on your own install.

**Backups**: Schedule 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.

**Upgrades**: Read each release's notes, then pull the new image and restart.

**Security**: TLS, firewall rules, secrets and patching the host.

**[Email delivery](https://feedback.quackback.io/hc/en/articles/83-email)**: Connect SMTP, Amazon SES or Resend for sign-in codes and notifications.

**[Inbound email](https://feedback.quackback.io/hc/en/articles/127-email-imap)**: To 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-in](https://feedback.quackback.io/hc/en/articles/97-oauth)**: Register your own app with Slack, Linear, GitHub and other providers once. On Cloud we provide them.

**An AI provider**: Quackback 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-hosted | Cloud |
|---|---|---|
| Price | Free, plus your hosting | Free plan; paid from $29/mo |
| Features | Every feature | By plan |
| Seats | Unlimited | 1 to unlimited, by plan |
| Servers, backups, upgrades | You run them | We run them |
| Quackback AI | Your own provider | Included, more on higher plans |
| Support | Community on GitHub | Email on paid plans |
| Uptime SLA | None | 99.9% on Enterprise |
| [Powered by Quackback badge](https://quackback.io/powered-by) | Always shown | Removable add-on |
|  | [View on GitHub](https://github.com/QuackbackIO/quackback) | [Start free trial](https://app.quackback.io/signup?plan=pro&from=self-hosted-table) |

## 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](https://quackback.io/contact.md).

## Run it yourself, or let us run it

[Start free trial](https://app.quackback.io/signup?plan=pro&from=self-hosted-final) [Self-hosting guide](https://feedback.quackback.io/hc/en/articles/98-self-hosting)
