𝐁𝐋𝐀𝐂𝐊 𝐇𝐀𝐓 𝐌𝐃 𝐕𝐄𝐑𝐒𝐈𝐎𝐍 𝟓.𝟎.𝟎

• Bot is Safe for Heroku so don't ask more questions

NOTICE!!! (TAP TO READ)

• For Vps/Panel Deployment You must download the zip from panel sections or from below link else your youtube downloaders wont work on panel.

𝟏. 𝐒𝐄𝐓 𝐔𝐏:

👇FORK REPO(A MUST)

𝗖𝗟𝗜𝗖𝗞 𝗛𝗘𝗥𝗘

• This is essential for you to obtain your own safe forked deployable repo especially heroku users.

𝟐. 𝐋𝐈𝐍𝐊 𝐖𝐈𝐓𝐇 𝐖𝐇𝐀𝐓𝐒𝐀𝐏𝐏

🔐 GET YOUR SESSION_ID

   

👉 Click any server above to generate your Session ID

⚠️ Session ID must start with BlackHat~

𝟑. 𝐃𝐄𝐏𝐋𝐎𝐘𝐌𝐄𝐍𝐓 𝐒𝐄𝐂𝐓𝐈𝐎𝐍:

TAP TO OPEN

• PostgreSQL is auto-provisioned via the heroku-postgresql:essential-0 addon — no manual setup needed.
• All environment variables are pre-filled from app.json. Just add your SESSION_ID.

(B) BOT HOSTING PANEL🔥(DISCORD) DEPLOYMENT

TAP TO OPEN

(C) RENDER DEPLOYMENT

TAP TO OPEN

Steps:

1. Fork this repo, then go to render.com and sign in.
2. Click New → Blueprint and connect your forked repo.
3. Render reads render.yaml and auto-provisions a free PostgreSQL database linked to your bot.
4. Fill in SESSION_ID when prompted. All other vars have defaults.
5. Click Apply — done.

Note: Render's free PostgreSQL lasts 90 days. After that, use a free external DB from neon.tech and paste the URL as DATABASE_URL. If left blank the bot falls back to SQLite automatically.

(D) RAILWAY DEPLOYMENT

TAP TO OPEN

Steps:

1. Fork this repo and go to railway.app.
2. Click New Project → Deploy from GitHub repo and select your fork.
3. In your project dashboard, click + New → Database → PostgreSQL.
4. Railway auto-links DATABASE_URL to your service — no copy-paste needed.
5. Go to your service Variables tab and add:
   • SESSION_ID → your BlackHat~ session ID
   • MODE → public
   • TIME_ZONE → e.g. Africa/Nairobi
6. Railway detects the Dockerfile and railway.toml automatically and deploys.

(E) KOYEB DEPLOYMENT

TAP TO OPEN

Steps:

1. Fork this repo and sign in to koyeb.com.
2. Click Deploy Now above (or Create App → GitHub → select your fork).
3. Koyeb has no built-in database — get a free PostgreSQL from one of:
   • neon.tech ← recommended
   • supabase.com
4. Paste the connection URL as DATABASE_URL in your Koyeb service environment variables.
5. Set SESSION_ID, MODE, TIME_ZONE in the same env vars section.
6. Koyeb uses the Dockerfile and koyeb.yaml config automatically.

Tip: If you skip DATABASE_URL the bot will use SQLite on the local disk — data resets on each redeploy. Use a remote DB for persistence.

(F) BOT HOSTING PANEL🔥(DISCORD) DEPLOYMENT

TAP TO OPEN

(G) VPS / SELF-HOSTED DEPLOYMENT

TAP TO OPEN

Requires a Linux VPS (Ubuntu 20.04+ recommended) with Node.js 20+ and Git installed.

1. Clone the repo

git clone https://github.com/clevertech977/black-hat-md.git
cd black-hat-md

2. Install dependencies

npm install

3. Set environment variables

Create a .env file in the project root:

SESSION_ID=BlackHat~your_session_id_here
MODE=public
TIME_ZONE=Africa/Nairobi
AUTO_LIKE_STATUS=true
AUTO_READ_STATUS=true
DATABASE_URL=              # leave blank to use SQLite, or paste a PostgreSQL URL

4. Install FFmpeg (required for media commands)

# Ubuntu / Debian
sudo apt update && sudo apt install -y ffmpeg

# CentOS / RHEL
sudo yum install -y ffmpeg

5. Start the bot

npm start

6. Keep it running with PM2 (recommended)

npm install -g pm2
pm2 start index.js --name black-hat-md
pm2 save
pm2 startup

7. (Optional) Free PostgreSQL

If you want a persistent database instead of SQLite, get a free connection URL from neon.tech or supabase.com and paste it as DATABASE_URL in your .env.

8. Update the bot

git pull
npm install
pm2 restart black-hat-md

𝟒. 𝐔𝐏𝐃𝐀𝐓𝐄𝐒

𝗖𝗟𝗜𝗖𝗞 𝗛𝗘𝗥𝗘

• CONTACT SUPPORT For More Info
• Join WHATSAPP CHANNEL for Daily Updates.
• Check out my Github Profile for More Projects.

𝟓. 𝐑𝐄𝐏𝐎 𝐒𝐓𝐀𝐑 𝐇𝐈𝐒𝐓𝐎𝐑𝐘