❤️ 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 Management Scripts by DigneZzZ

Comprehensive bash scripts for Remnawave Panel, Remnawave Node, and Reality Selfsteal with full automation support. Features Docker integration, intelligent backup/restore system with version checking, advanced monitoring, and complete lifecycle management.

📦 Key Features:

🚀 One-line installation for Panel, Node, and Selfsteal configurations
🎛️ Interactive menus with real-time status monitoring and guided operations
💾 Smart backup system with version compatibility checking and safety rollbacks
🔄 Complete lifecycle management - install, update, backup, restore, uninstall
🎯 Reality masking with 11 AI-generated website templates

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

Author: DigneZzZ

Project: GIG.ovh

🚀 Quick Install Commands

Remnawave Panel (v3.5.5+):

bash <(curl -Ls https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnawave.sh) @ install

Remnawave Node (v3.1.2+):

bash <(curl -Ls https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnanode.sh) @ install

Reality Selfsteal (v2.1.3+):

bash <(curl -Ls https://github.com/DigneZzZ/remnawave-scripts/raw/main/selfsteal.sh) @ install

Options:

Add --dev for development version
Add --name customname for custom directory (default: /opt/remnawave, /opt/remnanode)

For existing installations: Use install-script to add CLI wrapper only:

bash <(curl -Ls https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnawave.sh) @ install-script

bash <(curl -Ls https://github.com/DigneZzZ/remnawave-scripts/raw/main/remnanode.sh) @ install-script

⚙️ Available CLI Commands

Installation & Management:

install, update, uninstall
install-script, uninstall-script

Service Control:

up, down, restart, status, logs

Node-specific Commands:

core-update - Manual Update/Install Xray-core to latest version
xray-log-out, xray-log-err - View Xray logs
setup-logs - Configure log rotation

Configuration:

edit, edit-env, console (Panel only)

Interactive Menus:

Run remnawave, remnanode, or selfsteal without arguments for interactive menu
Real-time status monitoring and resource usage
Step-by-step guided operations

Backup & Restore (Panel):

backup - Create manual backup
schedule - Configure automated backups
restore - Restore from backup archive

Reality Selfsteal:

Choose from 11 AI-generated website templates
Automatic SSL certificate management by Caddy
DNS validation before start

Run remnawave help, remnanode help, or selfsteal help for detailed usage.

💾 Intelligent Backup & Restore System

🔄 Smart Backup Features:

Version-aware backups with compatibility checking
Safety restore with automatic rollback protection
Scheduled automation with cron integration
Telegram notifications with file delivery and alerts
Cross-server migration support with detailed instructions
Compressed archives with unified structure

📦 What's Backed Up:

PostgreSQL database as db_backup.sql
Configuration files: docker-compose.yml, .env, app-config.json
Optional: full directory backup with selective restore

🎯 Quick Commands:

remnawave backup          # Create instant backup
remnawave schedule        # Setup automated backups  
remnawave restore         # Intelligent restore with version checks

🛡️ Safety Features:

Automatic version compatibility verification
Safety backup before restore operations
Rollback capability if restore fails
Real-time status monitoring during operations

📋 Restore Options:

Full restore (replace all files and database)
Database-only restore (keep existing files)
Custom directory restoration
Manual restore commands included in each backup archive

Legacy Standalone Scripts:

Available for users who need legacy standalone backup/restore tools:

remnawave-backup.sh - Standalone backup script
restore.sh - Standalone restore script

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 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 Management Scripts by DigneZzZ​

Remnawave Reverse Proxy from eGames​

Installation Guidelines​

Installation​

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 Management Scripts by DigneZzZ

Remnawave Reverse Proxy from eGames

Installation Guidelines

Installation

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