Native Linux & Windows Installation Guide

Linux Installation (Ubuntu / Debian / RHEL)

For VPS environments without Docker, AutoTelegramForward can be installed directly as a background systemd daemon.

Method A: Automated One-Line Installer

curl -sSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/install.sh | bash

Method B: Manual Setup

# 1. Install prerequisites
sudo apt-get update && sudo apt-get install -y python3 python3-venv python3-pip git

# 2. Clone repository
git clone https://github.com/Opselon/AutoTelegramForward.git
cd AutoTelegramForward

# 3. Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 4. Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

# 5. Populate environment variables
cp .env.example .env
nano .env

# 6. Run core
python3 -m core.main

Systemd Service Configuration

Create /etc/systemd/system/autotelegramforward.service:

[Unit]
Description=AutoTelegramForward Engine
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/AutoTelegramForward
ExecStart=/root/AutoTelegramForward/.venv/bin/python3 -m core.main
Restart=always
RestartSec=5
EnvironmentFile=/root/AutoTelegramForward/.env

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable autotelegramforward
sudo systemctl start autotelegramforward
journalctl -u autotelegramforward -f

Windows 10 / 11 / Server Installation

AutoTelegramForward runs smoothly on Windows using PowerShell:

Method A: Automated PowerShell Installer

irm https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/install.ps1 | iex

Method B: Manual PowerShell Setup

# 1. Clone repository
git clone https://github.com/Opselon/AutoTelegramForward.git
cd AutoTelegramForward

# 2. Create and activate venv
py -m venv .venv
.\.venv\Scripts\Activate.ps1

# 3. Install requirements
pip install -r requirements.txt

# 4. Copy configuration
copy .env.example .env

# 5. Start engine
python -m core.main