Self-hosted OSINT exposure checker — is your email, username, phone or password leaked? Keyless sources: breaches, infostealer logs, COMB credentials, HIBP k-anonymity, 200-platform username grid. Docker one-command install, no API keys, no AI, Apache-2.0.
Self-Hosting Guide
Quick start (Docker, recommended)
git clone https://github.com/RanaKhan77/Exposure-Check-OSINT.git
cd Exposure-Check-OSINT
./install.sh # builds + boots one container, generates your password
Open http://localhost:8080/login and sign in with the printed password.
That is the whole install. Data (history, settings, license) lives in the
ec-storage Docker volume and survives upgrades.
Custom port: ./install.sh --port 9090
Custom password: ./install.sh --password 'your-strong-password'
Daily operations
docker compose -f docker/docker-compose.yml logs -f # follow logs
docker compose -f docker/docker-compose.yml restart # restart
docker compose -f docker/docker-compose.yml down # stop (data persists)
docker compose -f docker/docker-compose.yml pull || \
git pull && docker compose -f docker/docker-compose.yml up -d --build # upgrade
Exposing it remotely (recommended setup)
The container speaks plain HTTP. For anything beyond localhost, put a TLS reverse proxy in front — Caddy makes it one line:
exposure.example.com {
reverse_proxy 127.0.0.1:8080
}
nginx equivalent:
server {
listen 443 ssl http2;
server_name exposure.example.com;
ssl_certificate /etc/letsencrypt/live/exposure.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/exposure.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Then set APP_URL=https://exposure.example.com in .env so generated links are correct.
Without Docker (PHP 8.4+ on a VPS)
git clone https://github.com/RanaKhan77/Exposure-Check-OSINT.git && cd Exposure-Check-OSINT
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
sed -i "s|^ADMIN_PASSWORD=.*|ADMIN_PASSWORD=$(openssl rand -hex 12)|" .env
touch storage/app/database.sqlite
php artisan migrate --force
php artisan serve --host 127.0.0.1 --port 8080
Requires: PHP 8.4+ with pdo_sqlite, sqlite3, curl, mbstring, dom, openssl.
For a serious non-Docker deployment use php-fpm + your webserver. If you run
php artisan config:cache, remember to re-run it after ANY .env change
(cached config stops reading .env — the admin password is read at config
load time by design).
Using MySQL instead of SQLite
Set in .env:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=exposure_check
DB_USERNAME=...
DB_PASSWORD=...
Then php artisan migrate --force. SQLite is the default because an own-use
personal tool should not need a database server.
Backups
Everything that matters is in two places: storage/app/database.sqlite (or your MySQL)
and storage/ (which also holds your .env copy, logs and logo cache). The Docker volumes map to both. sqlite3 storage/app/database.sqlite ".backup backup.db"
takes a safe hot copy.
Scheduling (optional, non-Docker)
Since the v2 "no wall" license policy (Oct 2026) there are no scheduled license tasks
anymore — the default install makes zero unsolicited network calls. If you run without
Docker and later add scheduled features (e.g. you opted into LICENSE_HEARTBEAT=on for
the public install map), add one cron entry:
* * * * * cd /path/to/Exposure-Check-OSINT && php artisan schedule:run >> /dev/null 2>&1