❤️ Awesome Aura

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.

---

Aura Installation Scripts

Bash scripts to install and manage Aura Panel and Aura 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 aura or r-node and etc. (default: /opt/aura or /opt/auranode)

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/aura or /opt/auranode)

---

CLI Features

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

Run aura help or auranode help to see available commands.

---

Aura 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 Aura 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

---

Aura Backup Script

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

• The Aura database as db_backup.sql
• Either the entire specified folder (e.g., /opt/aura 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)"

---

Aura Restore Script

A bash script to restore Aura 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/aura 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)"

---

Aura 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	Aura API PLAIN DOMAIN(panel.domain.com)
REMNAWAVE_MODE	Aura mode (remote/local), default is remote. If local set – you can pass aura-backend:3000 to REMNAWAVE_URL
REMNAWAVE_TOKEN	Authentication token for Aura 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

1. Create a new directory for the mini app

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

2. Download the sample environment variables.

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

3. Configure the environment variables.

nano .env

4. 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:
#         - aura-network

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

Uncomment if you want to use your own template downloaded from the Aura 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:
        - aura-network

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

1. Run containers.

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

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

---

Ansible playbook for Install Aura

This project helps install Aura 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

---

Aura Telegram Shop Bot

A Telegram bot for selling subscriptions with integration to Aura. 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 Aura 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 Aura 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

---

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 Aura or useful for Aura 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.

к сведению

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