Aiogram Mongo Template

Telegram Bot template with aiogram, mongodb and docker

Technologies used:

• Aiogram
• Redis
• Beanie
• MongoDB
• i18n
• Docker and docker compose

Navigate

• Getting started
  • Init project
  • Configure environment variables
    • Bot config
    • Redis config
    • Database config
  • Application start (local)
• Docker
  • Application start (docker)
  • View app logs
  • Rebuild app
  • Manage mongodb

Getting started

Init project

$ git clone -b aiogram3 https://github.com/webshining/aiogram-mongo-template project_name
$ cd project_name
$ pip install -r requirements.txt

Configure environment variables

Copy variables from .env.ren file to .env

$ cp .env.ren .env

Bot config

TELEGRAM_BOT_TOKEN - your bot token (required)

I18N_DOMAIN - locales file name

Redis config

If you are not using redis, by default used MemoryStorage

RD_URI - connection url to your redis server

Database config

MongoDB URL format
> mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]

Specify one of the following options to configure MongoDB connection:

1. MONGO_HOST — MongoDB server address (e.g., localhost)
2. MONGO_PORT — MongoDB port (default: 27017)
3. MONGO_USER — username for authentication
4. MONGO_PASS — password for authentication
5. MONGO_NAME — database name

Or use a ready-to-use connection string in the MONGO_URL variable.

Application start (local)

$ python main.py
# If you have make you can enter
$ make run

Docker

Application start (docker)

Run only one service:
> $ docker-compose up -d service-name

$ docker-compose up -d
# If you have make you can enter
$ make rebuild

View app logs

$ docker-compose logs -f app
# If you have make you can enter
$ make logs

Rebuild app

$ docker-compose up -d --build --no-deps --force-recreate
# If you have make you can enter
$ make rebuild