DocumentationTelegram OSINT Identity Lookup OverviewOSINT Database Installation & Configuration

OSINT Database Installation & Configuration

To enable the OSINT Lookup backend, you must configure the database path variables so the Next.js API can query the SQLite database.

System Dependencies & Files

The OSINT lookup relies on two files that are not committed to Git due to their size:

  • SQLite Database File (tg_data.db) — Approximately 9.7 GB containing all indexed records and search indices.
  • Bloom Filter (bloom_filter.bin) — Approximately 134 MB containing the probabilistic membership set for instant existence checks.
  • Configuration Steps

    1. Place the Data Files

    Place both files in a secure directory on your local machine or VPS. For example:

  • Windows Local: D:\tg data
  • Linux VPS: /var/www/tg_data/
  • 2. Configure Environment Variables

    Add or update the following keys in your .env.local file:

    TG_DATA_DB_PATH="D:/tg data/tg_data.db"
    TG_DATA_BLOOM_PATH="D:/tg data/bloom_filter.bin"

    If running on a VPS, point them to the respective absolute file paths:

    TG_DATA_DB_PATH="/var/www/tg_data/tg_data.db"
    TG_DATA_BLOOM_PATH="/var/www/tg_data/bloom_filter.bin"