# Migrating to V3

Version 3 of QBittorrentBot introduces significant internal changes, including a full rewrite of the codebase, the switch to Aiogram, and new runtime data management via Redis. The configuration file format has also changed. This section explains the main differences and what you need to do to migrate from previous versions.

• The entire project has been rewritten for better performance and maintainability.
• UV (Universal Virtual Environment) is now used to manage dependencies and the project environment.
• The Telegram library is now Aiogram, a fully asynchronous framework replacing Pyrogram (deprecated).
• Database support has been removed. Redis is now used to store all runtime data, statuses, and cached information.
• The bot is now fully asynchronous, more robust, and optimized for larger workloads.

Future improvements:

• Implement Aiogram FSM for better state management
• Make the client manager fully asynchronous
• Add internalization (i18n) support using Aiogram

The configuration file has been completely redesigned:

• Old config.json → replaced by config.yml
• New fields:
  • redis → Redis connection string for runtime storage
  • users.notification_filter → optional filter to limit notifications to certain torrent categories
• Removed Pyrogram-specific fields (api_id and api_hash). Now only the Telegram bot token is required.
• Automatic configuration reload is supported — most changes take effect without restarting the bot, except when changing the Telegram bot token or redis url.

For more information please, check the configuration file page

{
  "client": {
    "type": "qbittorrent",
    "host": "http://192.168.178.102:8080",
    "user": "admin",
    "password": "admin"
  },
  "telegram": {
    "bot_token": "1111111:AAAAAAAA-BBBBBBBBB",
    "api_id": 1111,
    "api_hash": "aaaaaaaa",
    "proxy": {
      "scheme": "http",
      "hostname": "myproxy.local",
      "port": 8080,
      "username": "admin",
      "password": "admin"
    }
  },
  "users": [
    {
      "user_id": 123456,
      "notify": false,
      "locale": "en",
      "role": "administrator"
    }
  ]
}

client:
  type: qbittorrent
  host: http://192.168.178.102:8080
  user: admin
  password: admin

redis:
  url: redis://cache:6379/0

telegram:
  bot_token: 1111111:AAAAAAAA-BBBBBBBBB
  proxy:
    scheme: socks5
    hostname: 127.0.0.1
    username: proxyuser
    password: proxypass

users:
  - user_id: 123456
    role: administrator
    notify: true
    notification_filter: movies
    locale: en