VPS / Terminal Setup
Simple numbered steps. Every command is copyable. Just paste and go — no terminal knowledge needed.
📋Before You Start — Get These Values Ready
Have these values copied before starting Step 3 — you will need to paste them into the .env file.
| Variable | Where to Get It | Required? |
|---|---|---|
API_ID | my.telegram.org → API Dev Tools | Required |
API_HASH | my.telegram.org → API Dev Tools | Required |
ELITE_SESSION | @elite_session_maker_bot on Telegram | Required |
LOG_CHAT_ID | Your private channel ID (starts with -100) | Optional |
SUDO_USERS | Your Telegram user ID (get from @userinfobot) | Optional |
🚀Ubuntu / Debian VPS — Step by Step
Update VPS & Install Required Tools
Copy and paste this one command. It updates your server and installs Python, Git, and Tmux — everything you need.
| 1 | sudo apt update && sudo apt upgrade -y && sudo apt install python3-pip git tmux -y |
Download CipherElite
This downloads CipherElite onto your server and opens the folder.
| 1 | git clone https://github.com/rishabhops/CipherElite |
| 2 | cd CipherElite |
💡 If you forked the repo, replace the URL with your own fork URL.
Create Your Config File
This creates your .env file. After running this, a text editor opens — fill in your values (see table below), then save.
| 1 | cp sample.env .env && nano .env |
📝 In nano: fill your values → press Ctrl+O → press Enter → press Ctrl+X to exit.
Install Python Packages
Installs all the libraries CipherElite needs. Wait for it to finish.
| 1 | pip3 install -r requirements.txt |
Start a Tmux Session
Tmux keeps your bot running even after you close the terminal or disconnect from SSH.
| 1 | tmux new -s cipher |
⚡ A new terminal window appears — this is your tmux session. Run the next command inside it.
Start the Bot!
Run this inside your tmux session. Your bot will start and you'll see logs.
| 1 | python3 main.py |
✅ Bot is running! To leave it running in background: press Ctrl+B then press D. Done!
Bot is Running!
After pressing Ctrl+B → D to detach, you can safely close your terminal. Bot stays live 24/7.
⌨️Tmux Keys — Quick Reference
Ctrl+B → DDetach (bot keeps running in background)tmux attach -t cipherCome back to check your bot logsCtrl+CStop the bot (inside tmux session)tmux lsSee all running sessionstmux kill-session -t cipherStop bot and delete session📱Termux (Android) — Same Steps, Different Commands
Termux uses pkg instead of apt. Same idea — just copy and paste each one.
| 1 | pkg update && pkg upgrade -y && pkg install python git tmux -y |
| 1 | git clone https://github.com/rishabhops/CipherElite |
| 2 | cd CipherElite |
| 1 | cp sample.env .env && nano .env |
| 1 | pip install -r requirements.txt |
| 1 | tmux new -s cipher |
| 1 | python main.py |
On Termux, disable battery optimization for the Termux app so Android doesn't kill it. Settings → Apps → Termux → Battery → Unrestricted.
🔧Something Wrong? Fix It Here
❌ ModuleNotFoundError: No module named 'telethon'
✅ Fix — run this:
| 1 | pip3 install telethon |
❌ Bot stops when SSH disconnects
✅ Fix — run this:
| 1 | tmux new -s cipher (always run inside tmux!) |
❌ Permission denied on pip3
✅ Fix — run this:
| 1 | pip3 install --user -r requirements.txt |
❌ AUTH_KEY_UNREGISTERED / session not working
✅ Fix — run this:
| 1 | Get a new ELITE_SESSION from @elite_session_maker_bot |
🔒 Security Reminder
Never push your .env file to GitHub. It contains your ELITE_SESSION which gives full access to your Telegram account. It is already in .gitignore — but double check before every push.