Setup Instructions

Before starting, ensure you have:

• A Linux server or VPS
• Docker and Docker Compose installed
• A Telegram Bot token from @BotFather
• Remnawave panel with API token and X_API_KEY
• PostgreSQL support (included in docker-compose)

1. Clone the repository

   git clone https://github.com/Jolymmiels/remnawave-telegram-shop
   cd remnawave-telegram-shop

2. Create environment file

   cp .env.sample .env

3. Configure essential variables

   Edit .env with your settings:

   TELEGRAM_TOKEN=your_bot_token_here
   DATABASE_URL=postgresql://user:password@postgres:5432/remnawave
   REMNAWAVE_URL=https://your-panel.com
   REMNAWAVE_TOKEN=your_api_token
   X_API_KEY=tinyauth login:pass in base64
    ADMIN_TELEGRAM_ID=your_id
   PRICE_1=5
   PRICE_3=12
   PRICE_6=20
   PRICE_12=35

4. Start the bot

   docker compose up -d

5. Verify installation

   docker compose logs -f remnawave-telegram-shop-bot

   The bot is ready when you see “Starting bot” message.

6. Test the bot Send /start command to your bot on Telegram

To update to the latest version:

docker compose pull
docker compose down
docker compose up -d

• Check if container is running: docker compose ps
• Verify Telegram token is correct
• Review logs: docker compose logs remnawave-telegram-shop-bot

• Ensure PostgreSQL container is running
• Verify DATABASE_URL format
• Check database credentials

• Verify REMNAWAVE_URL is accessible
• Check REMNAWAVE_TOKEN validity
• Test API connectivity from the container

• Configure payment methods
• Set up environment variables
• Learn about admin commands