Installation

Install StavenCTL on the Linux server that will host your panel and services.

Install

Run the official installer.

curl -fsSL https://install.stavenctl.com/install.sh | sudo bash

After installation, verify that the agent is available.

stavenctl-agent --version
stavenctl-agent --help

Installed Components

The installer deploys the following components.

Component	Description	Installation Path
stavenctl-server	HostPanel backend server	`/var/lib/stavenctl/bin/stavenctl-server`
stavenctl-agent	Main management CLI and system agent	`/usr/local/bin/stavenctl-agent`
stavenctl-nginx	Custom Nginx binary	`/usr/local/stavenctl/nginx/sbin/stavenctl-nginx`
Web Files	Panel frontend assets	`/usr/local/stavenctl/web`
Configuration	Main configuration file	`/etc/stavenctl/config.conf`

Installed Services

The installer also installs and configures the required services.

Service	Purpose
PostgreSQL	Primary database
Redis	Cache and message broker
StavenCTL Server	Backend API
StavenCTL Agent	System management agent
StavenCTL Nginx	Reverse proxy and web server

Configuration

The main configuration file is located at:

/etc/stavenctl/config.conf

Edit this file to configure your database, Redis, networking, domains, TLS, and other server settings.

Verify Installation

Confirm the agent is installed correctly.

stavenctl-agent --version

Verify the backend service.

systemctl status stavenctl-server

Verify the agent service.

systemctl status stavenctl-agent

Verify the custom Nginx service.

systemctl status stavenctl-nginx

Directory Layout

/etc/stavenctl/
└── config.conf

/usr/local/bin/
└── stavenctl-agent

/usr/local/stavenctl/
├── nginx/
│   └── sbin/
│       └── stavenctl-nginx
└── web/

/var/lib/stavenctl/
└── bin/
    └── stavenctl-server

Next Step

Once installation is complete, continue with the configuration guide to initialize your server, configure PostgreSQL and Redis, and complete the first-time HostPanel setup.