Dodo Guard

ENRU

Installation guide

Deploy Dodo Guard on your own server

This guide covers a practical single-server setup: install the panel, configure the environment, start the service, and create your first managed VLESS Reality key.

dodo-guard-0.1.0-source.tar.gzzipReleases

Requirements

  • • A Linux server with root or sudo access.
  • • Node.js 22+ and npm.
  • • A local xray-core installation on the same server.
  • • A public domain or IP address that points to your server.

Create your first key

  1. 1. Open the panel and sign in with the admin account from your environment file.
  2. 2. Open the Identity and managed VLESS Reality section and save your public host, port, and Reality settings.
  3. 3. Create a managed VLESS client in the dashboard.
  4. 4. Copy the generated direct vless:// key, QR code, or the public import link.
  5. 5. Import it into DoDo APP and connect.

Quick install

Download a release archive, unpack it, install dependencies, and create the environment file.

mkdir -p /opt/dodo-guard
cd /opt/dodo-guard
tar -xzf dodo-guard-0.1.0-source.tar.gz --strip-components=1
npm install
cp .env.example .env.local

Environment

Set the public domain, admin credentials, and paths to your local xray binary and config file before the first production start.

DODO_GUARD_ADMIN_USERNAME=admin
DODO_GUARD_ADMIN_PASSWORD=change-this-password
DODO_GUARD_SESSION_SECRET=replace-with-random-secret
DODO_GUARD_PUBLIC_BASE_URL=https://panel.example.com
DODO_GUARD_XRAY_BINARY_PATH=/usr/local/bin/xray
DODO_GUARD_XRAY_CONFIG_PATH=/usr/local/etc/xray/config.json
DODO_GUARD_XRAY_SERVICE_NAME=xray

Run the panel

Build the app and start it behind your preferred reverse proxy. The panel creates its database automatically on first launch if data/db.json does not exist.

npm run build
npm run start

Current release version: 0.1.0.

Operational notes