Why does clicking 'Open in Fredy' in a notification lead to a blank page?

Update Fredy to v22.3.1 or later. Earlier versions had a broken link missing the '#' symbol; the correct format is '#/listings/listing/ '.

Why does the Area Filter show nothing and give 'RX is not defined' error in Fredy?

This bug was fixed in pull request #288. Upgrade to the latest master version or use version containing the merge to resolve the issue.

Why are Immowelt, eBay Kleinanzeigen, and WG-Gesucht not returning listings in Fredy after March 2026?

Update to Fredy 20.0.7 or later – this release switches the Docker base image from Alpine to Debian slim, allowing Puppeteer to manage its own compatible Chrome for Testing. If you cannot update, modify your Dockerfile: change `FROM node:22-alpine` to `FROM node:22-slim` (or `node:24-alpine`), remove the `PUPPETEER_SKIP_CHROMIUM_DOWNLOAD` and `PUPPETEER_EXECUTABLE_PATH` environment variables, and add the required Debian shared libraries. Then run `npx puppeteer browsers install chrome` during the build. The root cause is Alpine Chromium 146.0.7680.80 crashing inside containers due to missing `sched_getscheduler` syscall.

Fredy

620 stars·System Optimization·SHA-256 checksum verified

Fredy is a self-hosted real estate finder for Germany that automatically scrapes ImmoScout24, Immowelt, Immonet, eBay Kleinanzeigen, and WG-Gesucht, and sends instant notifications via Slack, Telegram, Email, ntfy, Discord and more.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self-hosted real estate finder for Germany: scrape major sites, get instant notifications via Slack/Telegram/email.

Core Features

Scrapes ImmoScout24, Immowelt, Immonet, eBay Kleinanzeigen, WG-Gesucht
Instant notifications via Slack, Telegram, Email, ntfy, Discord and more
Intuitive Web UI to manage searches with deduplication across platforms
Customizable search intervals, Docker support, and bare Node.js deployment
Built-in MCP Server (v20+) allows querying listings via natural language using LLMs

What It Can't Do

•Immoscout bot detection is aggressive; Fredy relies on a reverse-engineered mobile API which may break. Keep the project updated. 2. Search URLs must be sorted by date in the source platform. 3. Initial setup requires editing a config.json manually. 4. Anonymous analytics ping is enabled by default; can be disabled in config. 5. No hosted version; you must run it yourself.

Use Cases

Find apartments or houses in Germany and get alerted instantly when new listings appear
Consolidate searches from multiple real estate platforms into one dashboard with deduplication
Share listings with a team via Slack/Telegram channels
Privacy-conscious users who want full control over their data by self-hosting

Fredy is a self-hosted real estate finder designed specifically for the German housing market. It scrapes ImmoScout24, Immowelt, Immonet, eBay Kleinanzeigen, and WG-Gesucht, then notifies you via Slack, Telegram, Email (SendGrid, Mailjet), ntfy, Discord, and other channels. It features a clean web UI to manage searches, deduplication across platforms, customizable search intervals, and an optional analytics ping (anonymous). Built with Node.js and Docker, Fredy also includes an MCP Server (since v20) that lets you query your listings using natural language via LLMs like Claude or ChatGPT. The project reverse-engineers ImmoScout's mobile API for better reliability against bot detection.

Getting Started

Download installer

Click the button above to download the installer for your system

Visit Project Homepage

Install the software

Double-click the downloaded installer and follow the prompts

Docker: Prepare a config.json (sample in repo), then run docker run -d --name fredy -v fredy_conf:/conf -v fredy_db:/db -p 9998:9998 ghcr.io/orangecoding/fredy:master

Manual (Node.js ≥22): Clone repo, run yarn, then start backend (yarn run start:backend) and frontend (yarn run start:frontend) in separate terminals

Open http://localhost:9998, login with admin/admin, and create your first search job

Install Guide

Docker: Prepare a config.json (sample in repo), then run docker run -d --name fredy -v fredy_conf:/conf -v fredy_db:/db -p 9998:9998 ghcr.io/orangecoding/fredy:master
Manual (Node.js ≥22): Clone repo, run yarn, then start backend (yarn run start:backend) and frontend (yarn run start:frontend) in separate terminals
Open http://localhost:9998, login with admin/admin, and create your first search job

File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source

Environment Guide

Uninstall Info

Docker: docker stop fredy && docker rm fredy && docker volume rm fredy_conf fredy_db. Manual: stop both processes, delete project folder and any persisted data in /conf and /db.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info

LicenseOther

Last Updated2026-06-26 04:40:12

GitHub Repository Official Website

Having issues? Check the FAQ below

3 FAQs

Similar Projects

Huginn

Huginn lets you build agents that automate online tasks. Events propagate through a directed graph. Monitor web, Twitter, email, and more.

RSSHub

RSSHub is the world's largest open-source RSS network. It generates RSS feeds from virtually any website, with over 5,000 instances and a thriving community. Perfect for aggregating social media, news, blogs, and more.

Puter

An open-source internet computer that lets you access all your files, apps, and games from anywhere, with self-hosting for full control.