Repository navigation
Releases: Opselon/AutoTelegramForward
Release list
AutoTelegramForward v2.4.0
AutoTelegramForward v2.4.0 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- feat(getchannel): copy-ready -id list, -all scope and unique-id support by @Opselon in #236
- perf(tests): 3x faster Python suite — delete CI-duplicated audit gates, stop re-parsing the catalog per string by @Opselon in #239
- Pinned-first pickers, wizard id round-trip, per-rule replace toggles by @Opselon in #240
- fix(discovery): read pins from the raw pin list — the high-level dialog never carries them by @Opselon in #241
- docs(readme): live @AutoForwarderFreeBot test walkthrough + one-line command reference by @Opselon in #242
- feat: pinned-first chat pickers and a chat browser on the app and dashboard by @Opselon in #243
- Redesign Telegram command handling: unique ids, fast paths and domain boundaries by @Opselon in #244
- feat(cli): server-side admin console and safe .env configuration management by @Opselon in #245
- Version 2.4.0: server-side admin console and safe .env management by @Opselon in #246
Full Changelog: v2.3.0...v2.4.0
AutoTelegramForward v2.3.0
AutoTelegramForward v2.3.0 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- High-Performance Redis Integration: rate limiting, leases, Docker-ready deployment, measured QA by @Opselon in #158
- Fix: Redis lease coordination recovers after a transient startup outage (no restart needed) by @Opselon in #159
- Fix: Core lease coordination sends the configured Redis password by @Opselon in #160
- Phase 2: API-first multi-tenant task lifecycle by @Opselon in #161
- Hardening: session lifecycle, one-time login links with per-user cooldown, /reauth by @Opselon in #162
- openapi: resolve contract relative to CWD + route-without-auth regression test by @Opselon in #163
- apikey gate: openapi doc is public by @Opselon in #164
- postgres: create user_tasks in the bootstrap + split DDL on real statements (claim race, missing tables) by @Opselon in #165
- tasks: honest cancel/retry, abort on lease loss, claim only runnable kinds by @Opselon in #166
- core rpc: require a shared credential on the internal gRPC surface by @Opselon in #167
- tasks: bounded retention sweep for the terminal-task ledger by @Opselon in #168
- auth flow: make the revision guard real, not decorative by @Opselon in #169
- login: render a failure as a sentence, never a raw key or a stack trace by @Opselon in #170
- rows are mappings on both engines; text follows the recipient's language by @Opselon in #171
- identity: refuse an account-less caller instead of inferring a scope from it by @Opselon in #172
- ui: a fetched dialog list survives the bounds it is stored under by @Opselon in #174
- feat(website): premium product surface, documentation guides, and the responsive-hiding fix by @Opselon in #173
- ui: canonical button styles, catalog-driven input aliases, stricter cross-language tester by @Opselon in #175
- api: readiness gate — a deploy cannot be recorded as deployed while authentication is down by @Opselon in #176
- ui: style the dashboard buttons through the same funnel as every other panel by @Opselon in #177
- fix(sync): make the per-task Edit/Delete/Reply switches decide real engine behaviour by @Opselon in #178
- fix(i18n): localize the values interpolated into catalog templates by @Opselon in #179
- fix(header): a deleted header stays deleted, and its button belongs to its owner by @Opselon in #181
- fix(i18n): render the add-on catalogue from the catalog, not from literals by @Opselon in #182
- fix(setup): one interpreter range that actually works, and stop calling healthy ports silent by @Opselon in #180
- website: an API reference, response contract and security surfaces that cannot drift by @Opselon in #184
- fix(dedupe): a Duplicate Filters claim is only earned by a delivery by @Opselon in #185
- fix(i18n): name every setting in the user's language, not in English by @Opselon in #186
- fix(i18n): stop filling localized templates with English bodies by @Opselon in #187
- refactor(atfcli): layered CLI, full feature surface, wire contracts pinned by @Opselon in #183
- fix(replace): one authority for replacements, and a delete click that cannot hit its neighbour by @Opselon in #188
- fix(i18n): explain a setting in the user's language, not in English by @Opselon in #189
- fix(blacklist,whitelist): the menu now writes where the engine reads by @Opselon in #191
- fix(i18n): stop naming severities, categories and counters in English by @Opselon in #190
- fix(cleaner): every cleaner option now changes the outgoing message (STEER 09) by @Opselon in #192
- fix(i18n): one language list, and a language is named not coded by @Opselon in #193
- fix(filters): badge, ownership and ReDoS guard now match the engine (STEER 10) by @Opselon in #194
- fix(i18n): a value has to arrive in the template that shows it by @Opselon in #195
- fix(i18n): a setting's own words, and the reason it refused a value by @Opselon in #196
- fix(i18n): the condition logic is named, not coded by @Opselon in https://github.com/Opselon/AutoTelegramForward/...
AutoTelegramForward v2.2.4
AutoTelegramForward v2.2.4 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- Dead-letter queue: one owner-scoped contract, honest replay, bot + CLI + web recovery by @Opselon in #148
- Let a refused action say so on the wire (proto3 omitempty) and hold every client to it by @Opselon in #149
- Keep --json a promise: a refused dead-letter action still emits its body by @Opselon in #150
- Dashboard login: a single-use code, never a Telegram user id by @Opselon in #151
- Sessions were signed with a key anyone can compute (db path) by @Opselon in #152
- A tenant can set its own endpoint and key, and test them (web + bot + Android) by @Opselon in #153
- A refused endpoint reads as a refusal, and a private peer stays usable by @Opselon in #154
- Version 2.2.3 by @Opselon in #155
- Version 2.2.4: a task can only use its own tenant's bot, and the bot panel fails closed by @Opselon in #156
- A rule that names a session that does not exist is a refusal, not a 500 by @Opselon in #157
Full Changelog: v2.2.2...v2.2.4
AutoTelegramForward v2.2.2
AutoTelegramForward v2.2.2 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- Drive warnings and errors to zero: real crashes, log corruption, lint gate by @Opselon in #118
- Per-task option logic: AI off means off, edit sync stops duplicating, album modes reach the worker by @Opselon in #119
- Styled buttons (keyboardButtonStyle) + one way out of the task panel by @Opselon in #120
- Pass the button-style diagnostics into the core container by @Opselon in #121
- Delete sync works outside channels by @Opselon in #122
- Delivery lanes: a burst leaves in the source's order, not the order we read it by @Opselon in #124
- Bot route: deliver a task through a bot the owner attached by @Opselon in #123
- Task settings: choose a task's bot route from the bot, safely by @Opselon in #125
- Security: a bot token belongs to the tenant that pasted it by @Opselon in #126
- API: the bot route is a per-task setting on the control plane by @Opselon in #127
- Clients: name the delivery-route group in the web panel and the mobile sheet by @Opselon in #128
- Attach a bot from anywhere: token API + web and mobile control by @Opselon in #129
- Bot: every setting is now editable from Telegram, from the server's own registry by @Opselon in #130
- CI publishes the images; the host pulls them instead of compiling by @Opselon in #131
- Deploy summary reports the image it really deployed, and can move a subset by @Opselon in #132
- Give a bot defaults, and let every task override them by @Opselon in #133
- Make a bot's defaults reach the forwarder, not just the settings screen by @Opselon in #136
- Index the two reads that decide a message, and measure the result at 10k tenants by @Opselon in #137
- Build the Android release APK in CI, on demand by @Opselon in #135
- Let a client clear a default, and hand a setting back to it by @Opselon in #138
- Show a task's settings the way the forwarder sees them, and let the panel hand one back by @Opselon in #139
- Show where a bot-supplied setting comes from, and make "reset" hand it back by @Opselon in #140
- Show where a mobile task's setting comes from, and make "use default" hand it back by @Opselon in #141
- Let a Telegram-only user see what is stuck, what failed, and under which id by @Opselon in #142
- Do not report a healthy queue's zeroes as a backlog by @Opselon in #143
- Cut the next version: 2.2.2, with the parity guards that keep it true by @Opselon in #144
- Make the release workflow parse again — v2.2.2 shipped no APK because of one key by @Opselon in #145
- Give every image its own BuildKit cache — the release's clean-install raced itself by @Opselon in #146
- Make the release gate assert redaction in both directions by @Opselon in #147
Full Changelog: v2.2.1...v2.2.2
AutoTelegramForward v2.2.1
AutoTelegramForward v2.2.1 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- fix(mobile): stop stringified numbers blanking Rules/Chats, and stop the 9-destination bar running off-screen by @Opselon in #117
Full Changelog: v2.2.0...v2.2.1
AutoTelegramForward v2.2.0
AutoTelegramForward v2.2.0 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Rust Logger Engine (:6002) — High-throughput gRPC log ingestion with secret redaction, queryable structured logs, and a dedicated SQLite archive.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- fix(security): the port-probe regression test must not bind the wildcard itself by @Opselon in #110
- feat(routing): make the A -> C -> B branding hop actually deliver by @Opselon in #111
- feat(web): configure the A -> C -> B branding hop from the dashboard by @Opselon in #112
- feat(mobile): surface the A → C → B branding hop in the task editor by @Opselon in #113
- feat(core): compose the branding hop (A -> C -> B) with every message transform by @Opselon in #114
- fix(ci): publish releases again — build images per native runner (v2.2.0) by @Opselon in #115
- fix(release): start the smoke stack deterministically (clean-install exited 137) by @Opselon in #116
Full Changelog: v2.1.0...v2.2.0
AutoTelegramForward v2.0.0
AutoTelegramForward v2.0.0 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Python Logger Service (:6002) — Telemetry, queryable structured logs with dedicated SQLite storage.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- fix(dispatcher): prevent Pyrogram Str UTF-16 surrogate crash by @Opselon in #40
- feat(security): secure admin and client control planes with immutable ID authorization by @Opselon in #41
- feat(rules): 1:1 task overview and advanced settings parity across bot, web, and mobile by @Opselon in #42
- feat(core, api, web, mobile): TMA auth, full task lifecycle parity, and web dashboard bugfix by @Opselon in #43
- feat: Phase 2 advanced settings runtime execution + typed metadata validation by @Opselon in #44
- feat: wire keyword-reply add-on into pipeline runtime by @Opselon in #45
- feat: v2.0 app update parity (cleaner, duplicate filter, forward header, reply sync, 7 locales) by @Opselon in #46
- feat: v2.0 dashboards parity and android session/password persistence by @Opselon in #47
- chore(logging): standardize professional [PIPELINE:...] structured logging by @Opselon in #48
- fix(auth): handle updated_at column in admin bootstrap by @Opselon in #49
- fix: multilingual 1:1 UI translation and parity clean-up by @Opselon in #50
- fix: import SUPPORTED_LANGUAGES for _resolve_lang by @Opselon in #51
- fix(bot): multilingual dialog picker UI/UX, session reconnect & toast parity by @Opselon in #52
- fix(i18n): eliminate hardcoded strings in rule creation, main menu & submenus by @Opselon in #53
- fix(health): resolve live topology health checks and core gRPC network discovery by @Opselon in #54
- chore(release): bump version to 2.0.0 across all platforms by @Opselon in #55
Full Changelog: v1.5.2...v2.0.0
AutoTelegramForward v1.5.2
AutoTelegramForward v1.5.2 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Python Logger Service (:6002) — Telemetry, queryable structured logs with dedicated SQLite storage.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
Full Changelog: v1.5.1...v1.5.2
AutoTelegramForward v1.5.1
AutoTelegramForward v1.5.1 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Python Logger Service (:6002) — Telemetry, queryable structured logs with dedicated SQLite storage.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- feat(release): unified server+mobile release engineering (version endpoint, probe, manifest, CI gates, docs) by @Opselon in #37
- chore: bump to 1.5.1 (unified server+mobile release) by @Opselon in #38
Full Changelog: v1.5.0...v1.5.1
AutoTelegramForward v1.4.1
AutoTelegramForward v1.4.1 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Python Logger Service (:6002) — Telemetry, queryable structured logs with dedicated SQLite storage.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
autotelegramforward-*-portable.tar.gz |
Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
Full Changelog: v1.4.0...v1.4.1