/Nancy-last-heroku-mirror-bot

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

HEROKU DEPLOY GUIDE

Heroku CLI Guide

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://gitlab.com/mysterysd.sd/WZML-X && cd WZML-X

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 us --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.env

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.env, accounts.zip, token.pickle, All Private Files(optional)-

Only config.env 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.env
  • Sample config.env (Copy these and Paste in Editor and Fill Up) 
    BOT_TOKEN = ""
TELEGRAM_API = ""
TELEGRAM_HASH = ""
OWNER_ID = ""
UPSTREAM_REPO = ""
UPSTREAM_BRANCH = "hk_wzmlx"
DATABASE_URL = ""
BASE_URL = ""
TORRENT_TIMEOUT = "0"
  • After Setup Exit from Editor via CTRL + X, followed via y and Enter...

Helpful Commands:

  • Exit from nano : CTRL + X
  • Save File : CTRL + S
  • 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 main -f

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

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

All Heroku CLI Commands : Click Here

Variables Description:

  • 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 hk_wzmlx. Str
  • 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
  • TORRENT_TIMEOUT: Timeout of dead torrents downloading with qBittorrent and Aria2c in seconds. Int

    Must Add else Bot Crashes! Set to 0 even not Needed

  • DATABASE_URL: Database URL of MongoDb to store all your files and Vars. Adding this will be Helpful. Str

Branch Specifications:

  • All files to be Uploaded in main Branch and set Upstream as hk_wzmlx Branch