HEROKU DEPLOY GUIDE

---

1️⃣ METHOD 1: (Github Workflow Guide)

Expand All Steps to Deploy ^{Click Here}

Step 1 : Fork and Star the Repository

• Click the Fork button at the top-right corner of this repository.

  Star the repository to show your support.

Step 2 : Navigate to Your Forked Repository

• Access your forked version of the repository.

Step 3 : Enable GitHub Actions for your repo

• Go to the Settings tab of your forked repository.
• Enable Actions by selecting the appropriate option in the settings.

Step 4 : Run the Deployment Workflow to Deploy

1. Open the Actions tab.
2. Select the Deploy to Heroku workflow from the available list.
3. Click Run workflow and fill out the required inputs:

• BOT_TOKEN: Your Telegram bot token.
• OWNER_ID: Your Telegram ID.
• DATABASE_URL: MongoDB connection string.
• TELEGRAM_API: Telegram API ID (from my.telegram.org).
• TELEGRAM_HASH: Telegram API hash (from my.telegram.org).
• HEROKU_APP_NAME: Name of your Heroku app.
• HEROKU_EMAIL: Email address associated with your Heroku account.
• HEROKU_API_KEY: API key from your Heroku account.
• HEROKU_TEAM_NAME (Optional): Required only if deploying under a Heroku team account.
• UPSTREAM_REPO: Upstream Repo of your Fork or Main Repo

4. Run the workflow and wait for it to complete.

Step 5 : Finalize Setup of your bot

• After deployment, check logs in your Heroku dashboard, If problem, Reach to Support Group.
• Use the /bsettings command to upload sensitive files like token.pickle if needed as well as all the important Variables within it.

  NOTE : Don't Add any Other variable except the Variables mentioned here.

---

2️⃣ METHOD 2: (Heroku CLI Guide)

Expand All Steps to Deploy ^{Click Here}

Step 1 : Git clone this Repo and change directory

Make sure git is Installed in your system or quick run apt-get install git pip curl -y

git clone https://github.com/BeastBots/BeastDeploy deploy && cd deploy

Step 2 : Now Install Heroku in your Sytem or checkout Official Heroku Deploy Docs, or Download via apt-get or npm

For Android : Use termux (Download via FDroid) for CLI usage

The script requires sudo and isn’t Windows compatible.

curl https://cli-assets.heroku.com/install.sh | sh

Install with Ubuntu / Debian apt-get

curl https://cli-assets.heroku.com/install-ubuntu.sh | sh

Install via npm (Not Recommanded)

npm install -g heroku

Official Heroku Install Guide : Check Here

Step 3 : Login into Heroku and Log In CLI via Browser

With Browser

heroku login

OR

Without Browser

heroku login -i

• Put Heroku Email : Heroku Email email@example.com
• Put Heroku Password : Heroku API Key. Get from Here

Step 4 : Create Heroku App and specify stack and region with App Name

heroku create --region eu --stack container APP_NAME

To Be Noted: Copy the BASE_URL after the App is Created and Put the Value in BASE_URL when editing config.py

Notes:

• --region eu for Europe Server.
• --region us for United States Server.
• APP_NAME should be replaced with your unique app name (Optional). If not given it generates a random name.
• --stack container for setting stack to container for Dockerfile.
• --buildpack heroku/python for using build slug for repo deploy and build.

Step 5 : Now set all the Required Variables and Files into this Branch MAIN Repo like config.py, accounts.zip, token.pickle, All Private Files(optional)-

Only config.py Mabdatory with Only Mandatory Vars Only, After that Put all Private Files or Vars via Bot Settings /bs

To Edit Inside CLI (nano Editor): (Termux Users)

nano config.py

• Sample config.py (Copy these and Paste in Editor and Fill Up)

  BOT_TOKEN = ""
  TELEGRAM_API = 0
  TELEGRAM_HASH = ""
  OWNER_ID = 0
  UPSTREAM_REPO = ""
  UPSTREAM_BRANCH = "master"
  DATABASE_URL = ""
  BASE_URL = ""
  

• After Setup Save from Editor via CTRL + O and Enter, followed via CTRL + X !

Helpful Commands:

• Exit from nano : CTRL + X
• Save File : CTRL + O
• Check Help : CTRL + G
• Undo Changes : ALT + U
• ^ means CTRL (Termux Users)

Step 6 : Set Local git remote for Heroku. Give All Commands One by One.

git add . -f
git commit -m "HK Setup"
heroku git:remote -a APP_NAME

Step 7 : Now push to Heroku via git forcefully to build.

git push heroku master -f

Heroku Logs: When checking Logs, Use this will give Complete Logs.

heroku logs -a APP_NAME -t

• Add arg -t for Live Stream Logs and Use CTRL + C to Exit from it.

All Heroku CLI Commands : Click Here

---

🔠 Variables Description:

View All Variables ^{Click Here}

• BOT_TOKEN: Telegram Bot Token that you got from BotFather. Str
• OWNER_ID: Telegram User ID (not username) of the Owner of the bot. Int
• TELEGRAM_API: This is to authenticate your Telegram account for downloading Telegram files. You can get this from https://my.telegram.org. Int
• TELEGRAM_HASH: This is to authenticate your Telegram account for downloading Telegram files. You can get this from https://my.telegram.org. Str
• BASE_URL: Valid BASE URL where the bot is deployed to use torrent web files selection. Format of URL should be https://app-name-random_code.herokuapp.com/, where app-name is the name of your heroku app Paste the URL got when the App was Made. Str
• DATABASE_URL: Database URL of MongoDb to store all your files and Vars. Adding this will be Helpful. Str
• UPSTREAM_REPO: GitLab repository URL, if your repo is private add https://<deploy_token>:<password>@gitlab.com/<your_username>/<repository_name> format. Str.
  • NOTE: Don't forget to remove '<' and '>'. To generate gitlab Deploy Token. Follow This
    • Any change in docker you need to deploy/build again with updated repo to take effect.
    • No Need to delete .gitignore file or any File
• UPSTREAM_BRANCH: Upstream branch for update. Default is wzv3. Str

---

⚠️ Branch Specifications:

• All files to be Uploaded in this main Branch and set Upstream as master Branch of actual repo.

---

❤️ Credits:

• Beast Bots
• Silent Demon SD ( MysterySD )