Esc close↵ go to page
Home/Docs/VPS / Terminal
💻 VPS / Terminal Deploy

VPS / Terminal Setup

Simple numbered steps. Every command is copyable. Just paste and go — no terminal knowledge needed.

✅ Ubuntu 20.04+ ✅ Debian ✅ Termux (Android) ✅ Any Linux VPS

📋 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.

VariableWhere to Get ItRequired?
API_IDmy.telegram.org → API Dev ToolsRequired
API_HASHmy.telegram.org → API Dev ToolsRequired
ELITE_SESSION@elite_session_maker_bot on TelegramRequired
LOG_CHAT_IDYour private channel ID (starts with -100)Optional
SUDO_USERSYour Telegram user ID (get from @userinfobot)Optional

🚀 Ubuntu / Debian VPS — Step by Step

1

Update VPS & Install Required Tools

Copy and paste this one command. It updates your server and installs Python, Git, and Tmux — everything you need.

bash
sudo apt update && sudo apt upgrade -y && sudo apt install python3-pip git tmux -y
2

Download CipherElite

This downloads CipherElite onto your server and opens the folder.

bash
git clone https://github.com/rishabhops/CipherElite
cd CipherElite

💡 If you forked the repo, replace the URL with your own fork URL.

3

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.

bash
cp sample.env .env && nano .env

📝 In nano: fill your values → press Ctrl+O → press Enter → press Ctrl+X to exit.

4

Install Python Packages

Installs all the libraries CipherElite needs. Wait for it to finish.

bash
pip3 install -r requirements.txt
5

Start a Tmux Session

Tmux keeps your bot running even after you close the terminal or disconnect from SSH.

bash
tmux new -s cipher

⚡ A new terminal window appears — this is your tmux session. Run the next command inside it.

6

Start the Bot!

Run this inside your tmux session. Your bot will start and you'll see logs.

bash
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 → D

Detach (bot keeps running in background)

tmux attach -t cipher

Come back to check your bot logs

Ctrl+C

Stop the bot (inside tmux session)

tmux ls

See all running sessions

tmux kill-session -t cipher

Stop 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
Step 1
bash
pkg update && pkg upgrade -y && pkg install python git tmux -y
2
Step 2
bash
git clone https://github.com/rishabhops/CipherElite
cd CipherElite
3
Step 3
bash
cp sample.env .env && nano .env
4
Step 4
bash
pip install -r requirements.txt
5
Step 5
bash
tmux new -s cipher
6
Step 6
bash
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:

bash
pip3 install telethon

❌ Bot stops when SSH disconnects

✅ Fix — run this:

bash
tmux new -s cipher

❌ Permission denied on pip3

✅ Fix — run this:

bash
pip3 install --user -r requirements.txt

❌ AUTH_KEY_UNREGISTERED / session not working

✅ Fix — run this:

bash
# 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.

Previous: Telegram Deploy