❤️ Awesome Remnawave

Xray Checker

Xray Checker is a tool for monitoring proxy server availability with support for VLESS, VMess, Trojan, and Shadowsocks protocols. It automatically tests connections through Xray Core and provides metrics for Prometheus, as well as API endpoints for integration with various monitoring systems.

Author: kutovoys

Geo File Viewer

A utility for viewing the contents of geoip and geofile (.dat) files in the v2fly format.

Remnawave Installation Scripts

Bash scripts to install and manage Remnawave Panel and Remnawave Node via CLI. Includes Docker support, reverse proxy tips, Telegram integration, and .env generation.

📦 Full info, updates, and examples: /remnawave-scripts

Author: DigneZzZ

Quick install (latest by default)

Panel:

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnawave.sh)" @ install

Node:

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnanode.sh)" @ install

Add --dev to install the development version

Add --name customname to use a custom directory, exapmle remna or r-node and etc. (default: /opt/remnawave or /opt/remnanode)

Already installed?

Use install-script to install only the CLI wrapper for an existing setup:

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnawave.sh)" @ install-script

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnanode.sh)" @ install-script

Make sure the directory matches your existing one. (/opt/remnawave or /opt/remnanode)

CLI Features

install, update, uninstall, install-script,uninstall-script
up, down, restart, status, logs
edit, edit-env, console (just for panel)

Run remnawave help or remnanode help to see available commands.

Remnawave Reverse Proxy from eGames

Server Setup Using NGINX Reverse Proxy. This script is designed to streamline the setup of a reverse proxy server using NGINX and Xray, as well as to automate the installation of the Remnawave control panel and node. In this configuration, Xray operates directly on port 443, forwarding traffic through a socket that NGINX listens to.

Author: eGamesAPI

Installation Guidelines

Please read the Installation Guidelines before proceeding with the installation.

Installation

bash <(curl -Ls https://raw.githubusercontent.com/eGamesAPI/remnawave-reverse-proxy/refs/heads/main/install_remnawave.sh)

Features:

Support for automatic configuration updates via subscription
NGINX reverse proxy setup in combination with Xray
Cloudflare SSL certificates with automatic renewal
UFW setup for access management
BBR optimization for TCP connections

Remnawave Backup Script

A bash script to create backups of the Remnawave database and configurations. Backups are sent to a Telegram chat for easy access. The script backs up the following:

The Remnawave database as db_backup.sql
Either the entire specified folder (e.g., /opt/remnawave or user-defined) or specific files:
- docker-compose.yml
- .env
- app-config.json (custom file for the subscription page, see instructions)

Author: DigneZzZ

Install and Run

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnawave-backup.sh)"

Remnawave Restore Script

A bash script to restore Remnawave backups, either fully (files and database) or database-only, from a .tar.gz archive to a specified directory.

The script performs the following:

Clears all existing data in the specified database and restores it from db_backup.sql
Restores files to the chosen directory (e.g., /opt/remnawave or user-defined), including:
- docker-compose.yml
- .env
- app-config.json (custom file for the subscription page, see instructions)
Starts containers to ensure the restored setup is operational

Author: DigneZzZ

Install and Run

sudo bash -c "$(curl -sL https://github.com/DigneZzZ/remnawave-scripts/raw/main/restore.sh)"

Remnawave Telegram Subscription Mini App

This is a Telegram Subscription Mini App that allows users to view their subscriptions directly through Telegram. As a requirement for using the page, the Telegram ID must be set in the user's profile to ensure proper identification and linking of subscriptions.

Features:

View your subscriptions in the mini app
Multi-language support (English, Russian)

Author: maposia

Installation instructions

Environment Variables

The application requires the following environment variables to be set:

Variable	Description
`REMNAWAVE_URL`	Remnawave API PLAIN DOMAIN(panel.domain.com)
`REMNAWAVE_MODE`	Remnawave mode (remote/local), default is remote. If local set – you can pass remnawave:3000 to REMNAWAVE_URL
`REMNAWAVE_TOKEN`	Authentication token for Remnawave API
`BUY_LINK`	The URL for purchase actions
`CRYPTO_LINK`	Allows using encrypted links (currently supported Happ application)
`REDIRECT_LINK`	Allows you to specify a custom redirect page URL for deep links. Useful for handling protocols like `v2box://` in Telegram Desktop (Windows). For more details and examples, see Telegram Deep Link Redirect

Install and Run

Create a new directory for the mini app

mkdir /opt/remnawave-telegram-sub-mini-app && cd /opt/remnawave-telegram-sub-mini-app

Download the sample environment variables.

curl -o .env https://raw.githubusercontent.com/maposia/remnawave-telegram-mini-bot/refs/heads/main/.env.example

Configure the environment variables.

nano .env

Create docker-compose.yml file

nano docker-compose.yml

Example below:

services:
remnawave-mini-app:
    image: ghcr.io/maposia/remnawave-telegram-sub-mini-app:latest
    container_name: remnawave-telegram-mini-app
    hostname: remnawave-telegram-mini-app
    env_file:
        - .env
    restart: always
    # volumes:
    #   - ./app-config.json:/app/public/assets/app-config.json
    ports:
        - '127.0.0.1:3020:3020'
#      networks:
#         - remnawave-network

#networks:
#   remnawave-network:
#     name: remnawave-network
#      driver: bridge
#      external: true

Uncomment if you want to use your own template downloaded from the Remnawave panel.
P.S. File must be placed in the same directory as this docker-compose.yml file

volumes:
    - ./app-config.json:/app/public/assets/app-config.json

Uncomment if you want to use local connection via single network in docker

     networks:
        - remnawave-network

networks:
   remnawave-network:
     name: remnawave-network
      driver: bridge
      external: true

Run containers.

docker compose up -d && docker compose logs -f

Mini app is now running on http://127.0.0.1:3020
Now we are ready to move on to Reverse Proxy installation.

Remnawave Telegram Subscription Mini App

Ansible playbook for Install Remnawave

This project helps install Remnawave via Ansible.

Author: iphizic

Installation instructions

Clone repo and change dir

git clone https://github.com/iphizic/remna-playbook.git
cd remna-playbook

Now make Python .env:

python3 -m venv .env

Activate .env:

source .env/bin/activate

Install Ansible and requirements:

pip install -r requirements.txt
ansible-galaxy install -r requirements.yml

Make inventory and other vars

Make inventory like inventory.yml.example in inventory dir In directory group_vars make all.yml like all.yml.example

`Optional` Make some user but not root

warning

To run this playbook, the GitHub username must match the username in all.yml

ansible-playbook prepare-playbook.yml -u root -k

First question it is root password Second question it is password for the created user

Run install Remnaware:

ansible-playbook playbook.yml -K

Remnawave Telegram Shop Bot

A Telegram bot for selling subscriptions with integration to Remnawave. This service allows users to purchase and manage subscriptions through Telegram with multiple payment system options. YooKass | Telegram Stars | CryptoBot

Author: jolymmiles

RemnaSetup 🛠️

Universal script for automatic installation, configuration, and updating of Remnawave and Remnanode infrastructure. Includes installation of the control panel, node, subscription page, Caddy setup, Tblocker, BBR, WARP, and an automatic backup system with Telegram integration.

Author: Capybara-z

Quick Start

Option 1:

bash <(curl -fsSL raw.githubusercontent.com/Capybara-z/RemnaSetup/refs/heads/main/install.sh)

Option 2:

curl -fsSL https://raw.githubusercontent.com/Capybara-z/RemnaSetup/refs/heads/main/install.sh -o install.sh && chmod +x install.sh && sudo bash ./install.sh

🔥 Main Features:

📦 Complete Remnawave installation + Subscription page + Caddy
🌐 Remnanode installation with Caddy, Tblocker, BBR, and WARP
💾 Backup system with Telegram integration
♻️ Recovery from local backups and Telegram
🔄 Automatic component updates

Remnawave Backup & Restore by distillium

The script automates backups and performs a restore of the Remnawave database.

Author: distillium

Instruction

Installation

curl -o ~/backup-restore.sh https://raw.githubusercontent.com/distillium/remnawave-backup-restore/main/backup-restore.sh && chmod +x ~/backup-restore.sh && ~/backup-restore.sh

danger

As a precaution, use the restore function on the same panel version from which the backup was made (or create the backup from the latest panel version).

warning

This script is designed to perform meaningful maintenance operations on the Remnawave database. Although it has been thoroughly tested, its functions affect the entire database and its components. It is recommended that you carefully follow the script’s instructions before executing any commands.

tip

The script backups and restores only the entire database, as well as the .env and .env-node files (if they exist in the /opt/remnawave/ or /root/remnawave/ directory). The backup and recovery of all other files and configurations are entirely the responsibility of the user.

Features:

creating a manual backup and configuring automatic scheduled backups
notifications in Telegram with backup file attached
supports sending backup to Google Drive
restore from backup
backups retention policy (7 days) implemented
quick access from anywhere on the system with the rw-backup command

WARP Native Installer by distillium

This script installs Cloudflare WARP in “native” mode via WireGuard, without using warp-cli.

Author: distillium

It automates:

Installing the necessary packages (wireguard, resolvconf)
Downloading and configuring wgcf
Generating and modifying the WireGuard configuration
Connecting and checking status
Enabling autorun of the warp interface

Installing (performed on each desired node):

curl -sL https://raw.githubusercontent.com/distillium/warp-native/main/install.sh | bash

Templates for Xray configuration

📝 Show example outbound

{
 "tag": "warp-out",
 "protocol": "freedom",
 "settings": {},
 "streamSettings": {
   "sockopt": {
     "interface": "warp"
   }
 }
}

📝 Show example routing rule

{
  "type": "field",
  "domain": [
    "netflix.com",
    "youtube.com",
    "twitter.com"
  ],
  "inboundTag": [
    "Node-1",
    "Node-2"
  ],
  "outboundTag": "warp-out"
}

Deleting:

curl -sL https://raw.githubusercontent.com/distillium/warp-native/main/uninstall.sh | bash

Add project to the list

If you want to add your project to the list, please open a PR on GitHub.

Make sure that the target branch is main.

Also, the following requirements must be met:

Project must be open source.
Project must be related to Remnawave or useful for Remnawave users.

The following format must be used:

### Project name

Short project description.

[Project link or repository link](https://project.com)

![Project image](/awesome/project-name.webp)

Use the examples above to add your project to the list.

info

Please, use https://squoosh.app/ to compress the image. Format must be webp.
Add the image to the static/awesome directory.

Xray Checker​

Geo File Viewer​

Remnawave Installation Scripts​

CLI Features​

Remnawave Reverse Proxy from eGames​

Installation Guidelines​

Installation​

Remnawave Backup Script​

Install and Run​

Remnawave Restore Script​

Install and Run​

Remnawave Telegram Subscription Mini App​

Environment Variables​

Install and Run​

Ansible playbook for Install Remnawave​

Clone repo and change dir​

Now make Python .env:​

Activate .env:​

Install Ansible and requirements:​

Make inventory and other vars​

Optional Make some user but not root​

Run install Remnaware:​

Remnawave Telegram Shop Bot​

RemnaSetup 🛠️​

Remnawave Backup & Restore by distillium​

Installation​

WARP Native Installer by distillium​

Add project to the list​

Xray Checker

Geo File Viewer

Remnawave Installation Scripts

CLI Features

Remnawave Reverse Proxy from eGames

Installation Guidelines

Installation

Remnawave Backup Script

Install and Run

Remnawave Restore Script

Install and Run

Remnawave Telegram Subscription Mini App

Environment Variables

Install and Run

Ansible playbook for Install Remnawave

Clone repo and change dir

Now make Python .env:

Activate .env:

Install Ansible and requirements:

Make inventory and other vars

`Optional` Make some user but not root

Run install Remnaware:

Remnawave Telegram Shop Bot

RemnaSetup 🛠️

Remnawave Backup & Restore by distillium

Installation

WARP Native Installer by distillium

Add project to the list