Skip to content

Plans, expiry and renewal

How plans work

  • One plan per bot. Each bot has its own plan, bought when you create the bot.
  • Paid in Stars. You pay the price shown in Telegram Stars, inside the BotBarn app in Telegram, for example 100 Stars for 30 days. The free plan costs nothing. Current prices are on botbarn.dev.
  • 30-day plans renew automatically. Telegram charges the same price every 30 days and the bot keeps running. Turn renewal off at any time (see below); the plan then runs to its end date. Plans of another length are paid once.
  • Limits. The plan sets the bot's CPU, memory, storage (/data), network bandwidth and monthly transfer: Limits and isolation.

You see each bot's plan, end date and days left on the bot's Overview and in Billing.

Which plan

Plans differ in the CPU, memory, storage, bandwidth and monthly transfer the bot gets; each card shows all five. As a guide:

  • Free: try BotBarn with a small bot, such as an echo or reminder bot.
  • Basic: a light bot that answers commands for you or a small group.
  • Pro (recommended): a busier bot with more users, a database, scheduled jobs or AI calls.
  • Enterprise: a heavy bot, such as one that processes files or serves many groups.

A bot that runs out of memory is restarted, and a bot that uses its monthly transfer is slowed down (Limits). The bot's Usage page shows its use of each of the five limits, warns you at 80 % and suggests the cheapest plan that covers all of them when the bot needs one.

Automatic renewal

A 30-day plan paid in Stars is a Telegram Stars subscription. On each renewal Telegram charges the plan's price, the bot's plan is extended by 30 days from its current end date, and the payment appears in Billing.

  • Turn it off with the Renewal switch on the bot's Overview, with Stop renewing in the BotBarn app in Telegram, or in Telegram: Settings → My Stars → Subscriptions. The plan runs to its end date; nothing more is charged.
  • Turn it on again the same way, before the end date.
  • If a renewal payment fails (not enough Stars), you get a notice in Telegram and the plan runs to its end date. Renew it by hand to keep the bot running.
  • Deleting the bot stops its renewals.

A bot that renews automatically gets no "plan ends" banner or reminder.

Before the end date

For a plan that does not renew automatically: from 7 days before the end date, a banner in BotBarn names the bot and the date, with a Renew button. You also get a notice in Telegram from @botbarn_app, and by email if your account has a verified email. Renew before the end date to avoid any interruption.

Renew

Press Renew on the bot's Overview, on its plan in Billing, or in the BotBarn app in Telegram. Choose a plan, review and pay in Stars.

  • If the current plan has not ended, the new period starts when the current one ends: you lose no days by renewing early.
  • If it has already ended, the new period starts now.

The bot keeps its code, variables and Telegram token. After renewing an expired bot, press Start or Deploy.

At the end date

  • A running bot is stopped. Its last error reads Subscription expired.
  • You cannot start, restart or deploy it. Stop still works.
  • The bot, its code and its variables stay in your account. Renew to start it again.
  • Its /data folder is kept for 7 days after the end date, so renewing within 7 days finds the data intact; after that it is deleted. The bot's Overview shows the deletion date, and you can download the data first.

Deleting a bot

Deleting a bot stops it and removes its code, variables, deployments and /data folder. The time left on its plan is not refunded. Its payments stay in Billing. See Payments and refunds for refunds.