Install AppCluster

One command brings up a node on a brand-new server. Install the modules you need from the GUI afterward — they download on demand.

One-Line Install

Run as root. Installs the .NET runtime if missing, brings up the node as a appcluster-node systemd service. Install modules from the GUI afterward (or pass --all-modules).

curl -fsSL …/install.sh | sudo bash

Pin a specific version:

…

What the Script Does

Installs prerequisites (unzip, ICU) and the .NET 10 ASP.NET Core runtime if not present
Downloads the node package and extracts it to /opt/appcluster/node
Creates + starts a appcluster-node systemd service (unattended, bootstraps a solo cluster)
Waits for the API and logs in — node only; install modules from the GUI (or pass all-modules)

Requirements: curl, python3, root/sudo. Ubuntu 22.04+, Debian 12+, RHEL 9+, and other systemd distros.

Script Source

Review the full script before running:

Loading script...

One-Line Install

Run in an elevated PowerShell. Installs the .NET runtime if missing, starts the node, to C:\AppCluster. Install modules from the GUI afterward (or pass -AllModules).

irm …/install.ps1 …

Pin a specific version:

…

What the Script Does

Installs the .NET 10 ASP.NET Core runtime if dotnet is not on PATH
Downloads the node package and extracts it to C:\AppCluster\node
Registers + starts a Windows Service AppCluster (auto-start on boot, auto-restart; --non-interactive bootstraps a solo cluster). -NoService runs a background process instead
Waits for the API and logs in — node only; install modules from the GUI (or pass all-modules)

Requirements: PowerShell 5.1+, Administrator. Windows Server 2019+ and Windows 10/11.

Script Source

Review the full script before running:

Loading script...

Manual / options

The one-liners accept flags (append to the Linux command, or pass to ac-install.ps1):

--all-modules — install all 40 modules during setup (default is node-only)
--only alerting,metrics-collector,smtp-provider — install just those modules
--skip-node — node already installed; only push modules
--token <bearer> — use an API token instead of the default admin login
--install-root <path> — change the install location

From Source

Requires the .NET 10 SDK.

# Clone and run — the GUI Install button then builds modules from source
git clone https://github.com/MRBMRB/AppCluster.git
cd AppCluster
dotnet run -c Release --project src/AppCluster.Node

Joining a Cluster

After the first node is up, join more nodes:

# Get a join key from an admin on the first node
curl http://node1:5100/api/cluster/join-key   # (admin token required)

# Start a new node with --join
dotnet AppCluster.Node.dll --join ACJK-node1:5100-<secret>

See the documentation for production configuration and multi-node setup.

After Installation

Open the Dashboard

Go to http://your-server:5100. Default login admin / admin — change it.

Confirm Modules

Open the Modules page and install the ones you need — each downloads from clusterius.com on demand.

Read the Docs

Check the documentation for cluster setup, declarative config, and the API reference.