View on GitHub
Installation

Install Nexus in one command

The official installer takes care of the dependencies, configuration and service setup. You only need root access on a supported Linux distribution.

Quick install

Run this command on a fresh server as root. The script downloads Nexus from the official GitHub repository and configures it as a managed service.

bash · install
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Julien48003/nexus-bot-manager/main/scripts/install.sh)"
View install script Source repository

What the installer does

1

Installs required components

Installs Node.js 20 LTS if missing, and prepares all required system libraries.

2

Downloads the latest release

Fetches the most recent stable version of Nexus from the official GitHub Releases.

3

Configures Nexus

Generates a unique JWT secret, prepares the data directory, and applies a safe default configuration.

4

Sets up the service

Registers Nexus as a managed service so it starts automatically and survives reboots.

5

Opens the web interface

Once installed, Nexus is reachable through the web interface and ready for the first-run setup wizard.

Requirements

System requirements

Nexus is designed to run on small Linux servers. The footprint is intentionally light.

RequirementMinimum
OSDebian 11 / 12, Ubuntu 22.04 / 24.04
Node.js20 LTS
RAM512 MB
Storage1 GB
Accessroot

Supported environments

Nexus can be deployed on any supported Linux environment. Typical targets include:

  • Proxmox LXC containers
  • VPS instances (OVH, Hetzner, Scaleway, etc.)
  • Dedicated servers
  • Home servers and lab environments
  • Any other compatible Linux distribution
First login

Completing the setup

The first time you reach the web interface, Nexus runs a guided setup wizard that configures the essentials:

  • The administrator username and password.
  • The interface language (English, French, German).
  • The first Discord bot you want to run.

From that point on, the application is fully usable. See the documentation for details on each section of the interface.

Updates

Two ways to keep Nexus up to date

Both update paths preserve your .env, the data/ directory and every bot folder.

From the web interface Recommended

The easiest and most controlled path. Nexus handles the whole flow for you:

  1. Click Vérifier les mises à jour to detect new releases from GitHub.
  2. Click Mettre à jour to start the update.
  3. Watch the live progress and let Nexus reload automatically.

Nexus will check GitHub, download the new release, run the safe restart, and report progress in real time.

From the server

If you prefer running the update manually, use the official update script:

bash · update
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Julien48003/nexus-bot-manager/main/scripts/update.sh)"

The script automatically detects your existing installation and applies the latest release without touching your configuration.

View update script

What is preserved across updates

  • The .env file (configuration & secrets).
  • The data/ directory (Nexus internal data).
  • All bot folders under /opt/<bot-name>.

Have a question during install?

The documentation covers the full setup flow, and the issue tracker is the right place for bug reports.