Subdomain & Telegram Bot Configuration#

Set up a custom domain for your Mobazha store and connect a Telegram Bot for your storefront Mini App.

Part A: Custom Domain Setup#

For Docker Standalone Stores#

If you deployed with the Docker standalone installer:

Option 1: Set domain during installation

bash

curl -sSL https://get.mobazha.org/standalone | sudo bash -s -- --domain shop.example.com

Option 2: Add domain to an existing store

1. Point your domain's DNS A record to the VPS IP address
2. Wait for DNS propagation (usually 1-5 minutes)
3. Run:

bash

mobazha-ctl set-domain shop.example.com

The store automatically obtains a TLS certificate from Let's Encrypt.

For Native Binary Stores#

Start (or restart) with the domain flag:

bash

mobazha start --domain shop.example.com

DNS Setup#

At your domain registrar (Cloudflare, Namecheap, GoDaddy, etc.), create an A record:

TypeNameValueTTLAshop (or @)<VPS_IP>Auto / 300

If using a subdomain like shop.example.com, the "Name" field should be shop. If using the root domain example.com, the "Name" field should be @.

Verify#

After DNS propagation:

bash

# Check DNS resolution
dig +short shop.example.com

# Check HTTPS
curl -sI https://shop.example.com | head -5

Part B: Telegram Bot Setup#

Mobazha stores can be accessed as a Telegram Mini App via a Telegram Bot. This lets buyers browse and purchase directly inside Telegram.

Step 1: Create a Bot with BotFather#

1. Open Telegram and message @BotFather
2. Send /newbot
3. Choose a display name (e.g., "My Store")
4. Choose a username (e.g., my_store_bot) — must end with bot
5. BotFather will reply with a Bot Token — save it securely

Step 2: Configure the Mini App URL#

Tell BotFather where your store frontend lives:

1. Send /mybots to BotFather
2. Select your bot
3. Choose Bot Settings → Menu Button
4. Set the URL to your store:
   • SaaS store: https://app.mobazha.org/tma?store=<your-peer-id>
   • Standalone store: https://shop.example.com/tma

Step 3: Configure the Bot in Your Store#

In your store admin panel:

1. Go to Admin → Settings → Telegram
2. Enter the Bot Token from BotFather
3. Save

This enables:

• Order notifications in Telegram
• Buyer can message you through the bot
• Mini App storefront accessible via the bot's menu button

Step 4: Set Bot Description & Photo#

Back in BotFather:

1. Send /mybots → select your bot
2. Edit Bot → Edit Description: describe your store
3. Edit Bot → Edit About Text: short store summary
4. Edit Bot → Edit Botpic: upload your store logo

Step 5: Share Your Bot#

Your Telegram storefront is now live at:

text

https://t.me/<bot_username>

Share this link anywhere — buyers tap the menu button to open your Mini App store.

Credential Handling#

• Ask for explicit user consent before connecting to any server or entering credentials
• If the user shares a BotFather token, use it only for the immediate configuration task
• Never store, log, or display credentials after use
• Remind the user to keep tokens and passwords private
• The agent must not transmit credentials to any party other than the intended target