Skip to main content
Git
InfrastructureSourceAPIChangelog

Reference

Settings​

User​

Each person sets these for themselves in Settings.

SettingTypeDefaultWhat it does
Open the panel with the terminalbooleanfalseShow the Git panel when a terminal opens on a host that has it.
Panel sideselect"right"Where the panel sits next to the terminal.
Panel sizenumber360Width of the panel, or its height at the bottom, in pixels.
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
GitbooleanfalseManage git repos on this host from the Git tab.
Scan foldersstringFolders searched for repos when you scan this host. Separate them with commas. Default is the home folder.
Use sudobooleanfalseRun git as root with sudo. Only for repos that the login user cannot use.
Read onlybooleanfalseShow repos but never change them on this host.
Panel beside the terminalbooleantrueOffer the Git panel on this host's terminal tabs.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
git.useadmin, userSee git repos on hosts you can reach, and change them on hosts you can edit.
git.run-commandsadminSet a command that runs on the host after an auto pull brings in new commits.

Actions​

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

ActionRuns onRiskInputs
git.list-repos
List git repos
A hostRead only
git.fetch
Fetch a repo
One item on a hostChanges
git.pull
Pull a repo
One item on a hostChanges
git.push
Push a repo
One item on a hostChanges
git.checkout
Switch branch
One item on a hostChangesbranch
git.reset-hard
Reset a repo hard
One item on a hostDestructiveref
git.read-behind
Repos behind
A hostRead only
git.read-dirty
Repos with changes
A hostRead only
git.read-pull-failing
Auto pull failing
A hostRead only

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
credentials:readCriticalSee your passwords and keys. It can read the stored secret for any host you can reach.
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.
operations:provideMediumOffer actions. Its actions can be run from Automations, the CLI, the phone app and other places, by people allowed to use them.
notify:sendMediumSend alerts. To you or other users, and through the channels they set up.
hosts:readLowSee your host list. Names and addresses for hosts you can already see.
ui:surfaceLowAdd its own screens. Tabs, panels and settings you can hide later.
kv:ownLowRemember small settings. Kept separate from other plugins.

API​

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

Platforms​

Linux, Windows, macOS