ujust
What is ujust
?¶
Technically ujust
is not a package format, but are convenience commands that automate tasks using scripts which can be utilized to install specific software. There are also commands for system configuration and maintenance included here, so run ujust
commands at your own risk. If an application is available to install via a ujust
command but can also be obtained as a Flatpak, then it is recommended to use ujust
command over installing the Flatpak version on Bazzite.
Using ujust
¶
Open a host terminal and enter:
ujust
This will output a list of available commands.
ujust --choose
This will show a terminal user interface of ujust
commands that you can choose to execute with arrow keys or mouse input.
Attention
Commands that require values or flags do not function with this method.
Manually entering commands¶
Find the command you want to use and enter:
ujust <command>
You can search for specific commands by entering:
ujust | grep "<search keyword(s)>"
install-
: Install program, there is no configuration or uninstall commands at this timeget-
: Install an "extension" like Decky plugins, and if it is an extension then it can useget-
toosetup-
: Install program, provides uninstall and configuration options for after installconfigure-
: Configure something that came by default on the image- If it must be installed first, then it will be in
setup-
- If it must be installed first, then it will be in
toggle-
: Turns something on/off- Selection might be automatic or manual depending on implementation
fix-
: Fixes, patches or works around an issuedistrobox-
: Distrobox exclusive verb for useful Distrobox stufffoo
: Replace this with whatever the command is called- These are shortcuts that we have deemed necessary to not have a verb
- Examples:
ujust update
andujust enroll-secureboot-key
- Examples:
- These are shortcuts that we have deemed necessary to not have a verb
View each ujust
script's source code¶
If you would like to see what each script does for each command then open a host terminal and enter:
ujust --show <command>
Alternatively, you can find the ujust
commands locally in:
/usr/share/ublue-os/just
Note
This directory also shows hidden ujust
commands.
Uninstalling applications installed through ujust
¶
Most applications installed via a ujust
script would have to be uninstalled manually. Follow the instructions found on the project's website or README file in the source code to uninstall it properly.
This command Shows layered packages that may be installed from the Bazzite Portal / ujust
:
rpm-ostree status
ujust script overview¶
These are just some of the common Bazzite ujust scripts, there are much more available which are viewable with ujust --choose
as mentioned above
Maintenance Scripts¶
- ujust update - updates system, flatpaks, and containers all at once
- ujust regenerate-grub - Regenerate GRUB config, useful in dual-boot scenarios where a second operating system isn't listed
- ujust configure-grub - Configures GRUB boot menu visibility
- ujust fix-reset-steam - Reset the Steam folder back to a fresh state without removing games, music, saves, etc. Very useful if Steam is giving trouble or if you are getting a blank screen in Game Mode
- ujust fix-proton-hang - Force terminates all processes related to wine and proton. Useful if you can't launch games after a game fails to close properly
- ujust bios - Reboots straight into this device's BIOS/EUFI screen
- ujust restart-pipewire - Crackling audio? Restarting Pipewire sometimes fixes that
- ujust enroll-secure-boot-key - Enrolls the Nvidia driver & KMOD signing key for secure boot. You'll need this if you want to use Bazzite with Secure Boot enabled
- ujust clean-system - Cleans up old unused podman images, volumes, flatpak packages and rpm-ostree content
Configuration/Enabling Scripts¶
- ujust setup-waydroid - a configuration helper for Waydroid. More information in Waydroid Setup Guide
- ujust setup-virtualization - setup and configuure virtualization and vfio
- ujust setup-sunshine - toggle Sunshine Game Streaming host on or off
- ujust setup-luks-tpm-unlock - enable auto LUKS unlock via TPM
- ujust setup-decky - Install and configure Decky Loader
- ujust setup-boot-windows-steam - Adds a script in Steam to boot Windows which is useful for dual-boot setups
- ujust enable-tailscale - Enables support for Tailscale
- ujust enable-supergfxctl - Enable Supergfxctl, a GPU switcher for hybrid laptops
- ujust bazzite-cli - Bazzite CLI mod for Bluefin styled cli enhancements. More information in Bazzite Command Line Tools
Troubleshooting Scripts¶
- ujust logs-last-boot - Shows all messages from last boot
- ujust logs-this-boot - Shows all messages from this boot
- ujust device-info - Gathers useful device information to a pastebin. This is very useful for providing information when creating support tickets in the #Bazzite-Help section in Discord