selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Krawl logo

Self-host Krawl

v2.4.0

Cloud-native web honeypot with AI-generated deception pages

ReleaseOpen SourceMIT
Updated9 hours ago
LanguagePython
Setup difficultyModerate
Stars
820
Port
5000 (HTTP server)
Docker
ghcr.io/blessedrebus/krawl
Install with Docker
Krawl screenshot 1Krawl screenshot 2Krawl screenshot 3Krawl screenshot 4

What is Krawl?

Krawl is a cloud-native deception server built to spot and stall bad actors, crawlers, and scanners. It spins up convincing fake web apps — admin panels, config files, made-up credentials — to bait and flag suspicious traffic. Highlights: AI-crafted honeypot pages via OpenRouter or OpenAI, infinite spider-trap links, bogus WordPress and phpMyAdmin logins, trap paths in robots.txt, plausible usernames and API keys, canary-token alerts, randomized server headers, and a live dashboard with geo-attack maps, attack-type charts, threat campaigns, and deep IP forensics. Two run modes: Standalone (SQLite, one container, no outside services) for dev and homelabs; Scalable (PostgreSQL + Redis, horizontal scaling) for production. Prometheus metrics and a Grafana dashboard ship out of the box. The dashboard hides behind a secret URL; password-gated sections manage banlists, watchlists, deception pages, and webhooks for Cloudflare and other firewalls.

Should you self-host Krawl?

Krawl scores 55/100 on selfhost.directory (how scoring works) and ranks #31 of 78 in Security. It has 820 GitHub stars.

It shipped 11 stable releases in the past year. The latest, v2.4.0, came out on 11 September 2026. New versions land roughly every 4 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is pentagi (83/100, 32 610 stars). It scores higher overall, so compare the two before you pick. See Krawl vs pentagi side by side.

Features

  • AI-generated deception pagesRequires API key; disabled by default
  • Banlist federation
  • Canary token integration
  • Cloudflare banlist sync
  • Customizable wordlists
  • Fake credentials
  • Fake login pages
  • Firewall export
  • Honeypot paths in robots.txt
  • IP reputation analysis
  • Random error injection
  • Random server headers
  • Real-time dashboardHidden behind secret path; password-protected panels for admin functions
  • Spider trap pages
  • Tarpit for AI crawlersDisabled by default

Krawl README

How to install Krawl

Install Krawl with Docker

Environment variables
KRAWL_DASHBOARD_SECRET_PATH, KRAWL_DASHBOARD_PASSWORD, KRAWL_MODE, KRAWL_PORT, KRAWL_DELAY, KRAWL_CUSTOM_TEMPLATE_PATH, KRAWL_CANARY_TOKEN_URL

docker run -d
-p 5000:5000
-e KRAWL_DASHBOARD_SECRET_PATH="/my-secret-dashboard"
-e KRAWL_DASHBOARD_PASSWORD="my-secret-password"
-v krawl-data:/app/data
--name krawl
ghcr.io/blessedrebus/krawl:latest

Standalone mode with SQLite

Krawl releases & version history

More in Network Security

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…