Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/awesome-remnawave.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ import WarpNativeInstallerGuide from '/docs/awesome-remnawave/\_install-guides/w
import RemnavaweBedolagaBotGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-bedolaga-bot.md'
import RemnashopGuide from '/docs/awesome-remnawave/\_install-guides/remnashop.md'
import RemnawaveMinishopGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-minishop.md'
import MeowsShopGuide from '/docs/awesome-remnawave/\_install-guides/meows-shop.md'
import RemnawaveBackuperGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-backuper.md'
import XrayCheckerGuide from '/docs/awesome-remnawave/\_install-guides/xray-checker.md'
import WhiteboxGuide from '/docs/awesome-remnawave/\_install-guides/whitebox.md'
Expand Down Expand Up @@ -190,6 +191,22 @@ import InfraBillingGuide from '/docs/awesome-remnawave/\_install-guides/infra-bi
<RemnawaveMinishopGuide />
</ProjectCard>

<ProjectCard
id="meows-shop"
title="Meows Shop"
description="Telegram bot plus web cabinet for selling Remnawave subscriptions — in browser, PWA and Telegram Mini App. Tariff or period-based pricing, trial, promo codes, referrals, loyalty program and fortune wheel. Payments: YooKassa, Platega (SBP, cards, crypto), CryptoPay, Telegram Stars, plus Мой Налог auto-receipts for self-employed. HWID device slots with QR invites, in-cabinet support chat, lifecycle notifications, public landing page and seasonal themes. Admin panel in both Telegram and browser: users, tariffs, payments, promos, broadcasts, statistics and settings. One-command installer and Bedolaga migration."
author="MrMe0ws"
authorLink="https://github.com/MrMe0ws"
image="/awesome/meows-shop.webp"
githubRepo="MrMe0ws/remnawave-telegram-shop"
links={{
github: 'https://github.com/MrMe0ws/remnawave-telegram-shop',
telegram: 'https://t.me/meows_vpn_bot'
}}
>
<MeowsShopGuide />
</ProjectCard>

</CategorySection>

<CategorySection
Expand Down
63 changes: 63 additions & 0 deletions docs/awesome-remnawave/_install-guides/meows-shop.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
### 🔥 Features

- 🐾 **Bot + Web Cabinet** — one backend serves a Telegram bot, a browser cabinet, a PWA and a Telegram Mini App
- 💳 **Payments** — YooKassa (with optional proxy), Platega (SBP, cards, acquiring, crypto), CryptoPay and Telegram Stars, confirmed by webhook or polling
- 🧾 **Мой Налог** — automatic receipts for self-employed sellers, with an optional proxy for servers hosted outside Russia
- 📦 **Two sales modes** — classic per-period pricing, or a tariff catalogue where every plan carries its own price, traffic limit, device count and squads
- 📱 **HWID device slots** — per-tariff device limits, purchasable extra slots, and connect-by-link/QR invites so a second phone or a TV can be added without logging into the cabinet
- 💎 **Loyalty program** — XP levels that unlock renewal discounts, recalculated from purchase history
- 🎟️ **Promo codes & referrals** — discount and bonus-day codes, referral links with rewards and statistics
- 🎡 **Fortune wheel** — configurable sector weights and rewards, daily free spin, spins paid in subscription days, live winners feed
- 💬 **Support chat** — built-in chat between users and admins right in the cabinet
- 🔔 **Lifecycle notifications** — expiring subscription reminders, "paid but never connected" nudges with a video guide button, and win-back campaigns that issue a time-limited discount code
- 🧩 **Admin panel in Telegram and browser** — users, tariffs, payments with CSV export, promo codes, loyalty, broadcasts, statistics, bot settings, infrastructure and Remnawave sync
- 🔐 **Multiple login methods** — email with verification and password reset, Google, Yandex, VK, and the Telegram Login Widget
- 🎨 **Landing page & themes** — public storefront page with tariffs, connection steps and FAQ, plus a set of seasonal and colour themes for the cabinet
- 🛰️ **Squads** — separate internal and external Remnawave squads for paid users and for trials
- 🌐 **RU / EN** — both the bot and the cabinet are fully localized

### Requirements

Linux, Docker and Docker Compose. By default the project is installed into `/opt/remnawave-telegram-shop`.

### Quick Start

Interactive installer — clones the repository, helps fill in `.env`, brings the containers up, and optionally sets up the cabinet, a reverse proxy with SSL, and smoke checks.

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/MrMe0ws/remnawave-telegram-shop/main/scripts/meows-shop-setup.sh)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 security Installer Executes Mutable Content

This command passes content from the mutable third-party main branch directly to Bash without an immutable revision, integrity check, or review step. Pin or authenticate the installer so later upstream changes cannot silently execute with the operator's shell privileges.

How this was verified: The documented curl response is consumed directly by Bash from a main-branch URL with no checksum or pinned revision.

Knowledge Base Used: Panel deployment

```

### Manual Installation

```bash
git clone https://github.com/MrMe0ws/remnawave-telegram-shop.git
cd remnawave-telegram-shop
cp .env.sample .env
# edit .env — at minimum TELEGRAM_TOKEN, REMNAWAVE_URL, REMNAWAVE_TOKEN,
# DATABASE_URL, PRICE_1…PRICE_12, ADMIN_TELEGRAM_ID, HEALTH_CHECK_PORT
docker compose up -d
```

### Update

Run from the installation directory:

```bash
cd /opt/remnawave-telegram-shop
docker compose pull
docker compose down && docker compose up -d
Comment on lines +48 to +49

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Commands Miss Deployment Directory

When an operator uses Quick Start and later runs these commands from their normal shell directory, Docker Compose fails or targets another project; the migration command at line 54 likewise cannot locate its relative script. Enter /opt/remnawave-telegram-shop before documenting these lifecycle commands.

Knowledge Base Used:

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

```

### Migration from Bedolaga

Interactive tool that moves existing users and tariffs over.

```bash
cd /opt/remnawave-telegram-shop
./scripts/meows-bedolaga-migrate.sh
```

:::tip
Remnawave `3.3.*` works with bot `5.x`. For panel `2.8.*` use bot `4.x` (frozen). Full matrix is in the repository documentation.
:::
Binary file added static/awesome/meows-shop.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.