Servus

Servus is a small terminal UI for starting and watching local services during development.

Maturity warning: As of now, platforms other than Windows don't request a graceful exit (ctrl-c) for started services and resort to killing them. Windows does this only as a fallback. Otherwise, my biggest maturity concern is that services may stay alive under certain edge conditions. This will hopefull be ironed out in the future.

Install

Servus is distributed as a .NET tool:

dotnet tool install --global IronStone.Servus

Update an existing installation:

dotnet tool update --global IronStone.Servus

Uninstall:

dotnet tool uninstall --global IronStone.Servus

First Run

Create a sample configuration in the current directory:

servus init

Edit the generated servus.yaml, then start the UI:

servus

Use another configuration file:

servus --config path\to\servus.yaml

Configuration

servus.yaml defines reusable profiles and tasks. The generated sample shows the available task options, including commands, working directories, profiles, shortcuts, ports, and connection checks.

Requirements

• .NET 9 or newer runtime