myanesp/telegram-immich-bot repository overview

⁠Telegram to Immich Bot

⁠Why?

This Docker container provides a simple way to automatically upload files from Telegram to your Immich photo management system. It's perfect for:

• Automatically backing up photos/videos sent to a Telegram bot
• Creating a simple upload pipeline for your personal media
• Integrating Telegram with your self-hosted photo management system

⁠Features

✅ Automatic file uploads from Telegram to Immich ✅ Preserves original file metadata (for images) ✅ User restriction control (only allow specific Telegram user IDs) ✅ Simple configuration via environment variables

⁠How to Run

1. Set up your Telegram bot:

   • Create a new bot using @BotFather⁠
   • Note down your bot token
   • Start a chat with your new bot

2. Configure your Immich instance:

   • Ensure your Immich API is accessible from the host
   • Generate an API key from your Immich settings

3. Run the container and send a file! This image is available both on Docker Hub⁠ and GitHub Container Registry⁠, so you're free to choose from which one you're going to download the image. Edit the following docker compose/docker run command to match your needs and you are ready to go!

⁠Run with Docker Compose

version: '3'
services:
  telegram-immich-bot:
    image: ghcr.io/myanesp/telegram-immich-bot:latest # or myanesp/telegram-immich-bot
    container_name: telegram-immich-bot
    restart: unless-stopped
    environment:
      - TELEGRAM_BOT_TOKEN=your_telegram_bot_token
      - IMMICH_API_URL=http://your-immich-instance/api
      - IMMICH_API_KEY=your_immich_api_key
      - ALLOWED_USER_IDS=user1_id,user2_id # Optional: restrict to specific users

⁠Run with Docker run

docker run -d \
  --name telegram-immich-bot \
  --restart unless-stopped \
  -e TELEGRAM_BOT_TOKEN=your_telegram_bot_token \
  -e IMMICH_API_URL=http://your-immich-instance/api \
  -e IMMICH_API_KEY=your_immich_api_key \
  -e ALLOWED_USER_IDS=user1_id,user2_id \ # Optional
  ghcr.io/myanesp/telegram-immich-bot:latest # or myanesp/telegram-immich-bot

⁠Environment Variables

⁠Planned features

• Multiarch support
• Multilingual support
• Reduce Docker image size