umcli

umcli is a utility included in Ultramarine. It has many planned features, and this is a list of current and planned ones.

Current Features

Syntax: um [global options] command [command options]

Global Options

-h, --help — Display the um help screen if not attached to commands. Displays the Command’s help page if run before a command. Just running um will also show the base um help screen.

Commands/Features

status — Displays information about the system. This includes system version info, hardware overview, disk information, system status, network information, and more.

  • --upload — Creates a shareable link to view your system specs online. This information is end-to-end encrypted, auto-expires in 7 days, and not tied to you in any way.
  • --json — Outputs status in JSON format.

system-version-upgrade — Upgrades your system to the next major release version (for example, Ultramarine 43 to 44).

  • --yes, -y Automatically accept the upgrade without prompts, same behavior as dnf’s —assumeyes (default: false)
  • --check Check if a newer version is available without upgrading (default: false)
  • --allowerasing Forcefully remove some packages (this is potentially destructive! make sure you know what you’re doing) (default: false)
  • --help, -h show help

env — Manage local bootc derivations (only useful if running on a bootc system. If you don’t know what this is you do not need this).

  • init Create a bootc environment manifest and containerfile
  • build, b Build the local derivation from a Containerfile
  • apply-changes Apply pending changes to the bootc environment
  • update Update the base image and rebuild the environment
  • help, h Shows a list of commands or help for one command
  • Package management helpers: add, install, i, a, in Add a package to the environment remove, uninstall, rm, r Remove a package from the environment
  • --help, -h show help

tweaks — Manage Ultramarine Tweaks. Tweaks are Ansible playbooks or arbitrary shell scripts that modify the system following a preset. This can be used to configure specific software, change system settings, and more.

  • list — Lists all available tweaks.
  • enable TWEAK — Enables a tweak.
  • disable TWEAK — Disables a tweak.
  • run TWEAK — Runs a script tweak
  • --yes, -y — Automatically answer yes to all prompts. Use with caution.

List of umcli Tweaks:

TweakTypeFunctionNotes
cleanup-old-kernelsOneshotRemove all but the 2 most recent kernels
mtu-probingToggleableEnable MTU probing
openssl-legacy-negotiationToggleableUse unsafe legacy negotiation for OpenSSLShould only be used if absolutely necessary
sudo-pwfeedbackToggleableAdd * feedback when entering in password during a sudo prompt
cachyos-kernelToggleableInstall the CachyOS kernel via the COPR, and enable as default kernel entryIf you are using Secure Boot, you will need to set up sbctl according to the CachyOS specification. More info can be found when enabling the tweak
nixToggleableInstall/Uninstall the Nix package manager

Planned Features

  • umcli upgrade, potentially a wrapper around the topgrade package. Would update everything on the system (system packages, flatpaks, firmware, etc.).
  • um get PACKAGE. A way to easily install packages that are not in a common package repository, but do distribute their own RPMs, or their own repositories. Based on deb-get
  • And more!

Next Up: eduroam →

← Back To: Switching Ultramarine Desktop Editions