Skip to content

MythosMachina/ServiceManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Service Manager (Non-Native systemd Services)

Web-based service manager with PAM login and group gating; lists non-native systemd services and allows start/stop/restart. grafik

What it does

  • Authenticates against local users via PAM; access is limited to a Unix group (default svcweb).
  • Hides Ubuntu/native services using package priority, prefixes, and allowlists; shows custom/optional services.
  • Dark UI with search, favorites (stored in browser), and start/stop/restart actions.
  • Ships with systemd unit, installer, and group/user helper.

Requirements

  • Systemd-based Linux, root/sudo privileges.
  • Node.js and npm available (installer runs npm ci --omit=dev).

Quick install

sudo ./install.sh

Defaults (override via env):

  • APP_DIR=/opt/service-manager
  • SERVICE_NAME=service-webui
  • PORT=3001
  • ACCESS_GROUP=svcweb

What the installer does:

  1. Copies the app to APP_DIR and runs npm ci --omit=dev.
  2. Ensures the access group exists.
  3. Creates /etc/default/service-webui with PORT/ACCESS_GROUP/SESSION_SECRET if missing.
  4. Installs the systemd unit, reloads daemon, enables and starts the service.

Add users to the access group

Use the helper to add existing (or create new) users to the group:

sudo ./setup.sh

You will be prompted for usernames; leave empty to finish. Non-existing users can be created on the fly (disabled-password).

Usage

  • UI: http://<host>:PORT
  • Login with any local account that is in the access group.
  • Filter services with the search field; pin favorites via the star icon to keep them on top.

License

MIT © MythosMachina — https://github.com/MythosMachina/ServiceManager

About

A Simple Servicemanager for Unix Systems

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors