Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SCTR

Introduction

SCTR is a Rust/systemd hosting control plane for long-running non-PHP applications. It provisions and controls one systemd unit per application, runs tenant applications with the tenant's operating-system identity, and exposes scoped lifecycle, status, and log operations.

Nginx and per-account PHP-FPM remain responsible for PHP and HTML. SCTR is for Node.js, Python, Go, Rust, workers, WebSockets, schedulers, and similar long-running applications.

The first target is a small, auditable control plane rather than a generic systemd proxy. The 0.0.1 contract will be accepted only after the smallest end-to-end hosting workflow is proven.

Documentation

Build

SCTR requires Rust 1.85 or newer and uses the Rust 2024 edition:

cargo build
cargo test

The repository still contains the superseded Python prototype for historical reference. It is not part of the Rust build or runtime.

Usage

The first executable slice provides an agent-facing command tree and detailed operational help:

sctr help
sctr help app
sctr help app start

The accepted application contract is:

sctr app list
sctr app status <app>
sctr app start <app>
sctr app stop <app>
sctr app restart <app>
sctr app logs <app>

Lifecycle execution currently fails closed until the registry policy and typed systemd adapter are implemented. The help surface documents those prerequisites rather than reporting false operational success.

Support

The sctr project is one of Candango Open Source Group initiatives. It is available under Apache License, Version 2.0.

This website and all documentation are licensed under Creative Commons 3.0.

About

Supervisor Controller

Resources

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages