Skip to main content
Services
InfrastructureSourceAPIChangelog

Reference

Settings​

User​

Each person sets these for themselves in Settings.

SettingTypeDefaultWhat it does
Open the services panel with a terminalbooleanfalseShow the services panel when a terminal opens on a host that has it.
Services panel sideselect"right"Where the panel sits next to the terminal.
Services panel sizenumber360Width, or height at the bottom, in pixels.
Services panel edge buttonbooleantrueShow a small button on the terminal edge to open the panel.

Host​

Set per host in the host editor, on the plugin's tab. Host defaults can set them for many hosts at once.

SettingTypeDefaultWhat it does
ServicesbooleanfalseShow the Services tab for this host to manage systemd services, timers and logs.
Use sudobooleantrueRun changes and protected reads with passwordless sudo when the login is not root.
Read onlybooleanfalseAllow reading services and logs, but block every change from Termix.
Log foldersstring"/var/log"Folders the Log files view may read, separated by commas.
Panel beside the terminalbooleantrueOffer a services panel next to this host's SSH terminal.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
service-manager.useadmin, userOpen the Services tab on hosts you can reach. Changes also need edit access to the host.

Actions​

Run these from Operations Center, Automations, the CLI (termix ops), the phone app or the API. See actions.

ActionRuns onRiskInputs
service-manager.list-services
List services
A hostRead only
service-manager.failed-units
Failed services
A hostRead only
service-manager.start
Start service
One item on a hostChanges
service-manager.stop
Stop service
One item on a hostChanges
service-manager.restart
Restart service
One item on a hostChanges
service-manager.reload
Reload service
One item on a hostChanges
service-manager.enable
Start at boot
One item on a hostChanges
service-manager.disable
Do not start at boot
One item on a hostChanges
service-manager.enable-now
Start now and at boot
One item on a hostChanges
service-manager.disable-now
Stop now and at boot
One item on a hostChanges
service-manager.mask
Mask service
One item on a hostDestructive
service-manager.unmask
Unmask service
One item on a hostChanges
service-manager.reset-failed
Clear failed state
One item on a hostChanges
service-manager.revert
Revert to the packaged unit
One item on a hostDestructive

Capabilities​

What the plugin's code is allowed to do. Termix shows this list before you install it. See capabilities for all of them.

CapabilityRiskWhat it means
ssh:connectHighRun commands on your servers. Any command, on hosts you connect it to, with your access.
users:impersonateHighAct as other users. Runs background work with another user's access, such as scheduled jobs. Every use is written to the audit log.
credentials:useMediumConnect to your servers. It cannot see your passwords or keys.
network:serveMediumAccept connections. It opens a port on the Termix server.
notify:sendMediumSend alerts. To you or other users, and through the channels they set up.
operations:provideMediumOffer actions. Its actions can be run from Automations, the CLI, the phone app and other places, by people allowed to use them.
hosts:readLowSee your host list. Names and addresses for hosts you can already see.
db:ownLowStore its own data. Kept in its own tables, separate from other plugins.
ui:surfaceLowAdd its own screens. Tabs, panels and settings you can hide later.

API​

The plugin's HTTP routes are in the API reference.

Platforms​

Linux, Windows, macOS