# Firecrawl-postgres

Firecrawl-postgres is a self-hosted databases app. Firecrawl NuQ PostgreSQL is the dedicated PostgreSQL database for a self-hosted Firecrawl deployment, storing its NuQ job queue and application data. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2817/firecrawl-postgres

## Description

Firecrawl NuQ PostgreSQL is the dedicated PostgreSQL database for a self-hosted Firecrawl deployment, storing its NuQ job queue and application data. It runs the official Firecrawl nuq-postgres image and connects to Firecrawl over the Docker network with no host port required, giving self-hosters a ready-to-use backing database without managing a separate generic PostgreSQL server.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

41/100 (Fair), based on 2 of 4 factors.
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/firecrawl-postgres-1wl68du0mk5ytq?q=firecrawl-postgres
- Official website: https://firecrawl.dev

## Common questions

### Does Firecrawl-postgres require a host port to be exposed?

No. The PostgreSQL service listens on internal port 5432, and Firecrawl connects over the Docker network, so no host port is needed.

### Which PostgreSQL connection environment variables should be configured?

Configure POSTGRES_USER, whose default is postgres, POSTGRES_PASSWORD, which is required, and POSTGRES_DB, whose default is postgres.

### Where is Firecrawl-postgres data stored for backups?

Data persists at /mnt/user/appdata/firecrawl/postgres.

### Does the Python SDK require an API key for scrape or crawl requests?

Yes. Create the Firecrawl client with your API key, the fc- value that identifies your account. Without it, Firecrawl will not accept scrape or crawl requests.

### Why might scraping jobs fail or return empty results in a self-hosted Firecrawl deployment?

Install Playwright and its browser packages when setting up the scraping service. They provide the real browser used to load pages, and without them some scraping jobs can fail or return empty results.

---
Source: Our Local Host (https://ourlocalhost.com/app/2817/firecrawl-postgres), the self-hosted and open-source app directory.
