Skip to content

3. Usage

Chiron edited this page Jul 5, 2026 · 9 revisions

Commands

There are 6 commands:

  • install
  • uninstall
  • clean
  • sync
  • list
  • license

Install

Usage: sudo centaur install [PACKAGE]

Will install the specified package by running the relevant .centaur file. Will also install needed dependencies

Install with no verification

By default the contents of the .centaur file for the package being installed is checked to make sure it hasn't been tampered with. While not advised, you can use the no_hash_check option to disable this feature. This may be useful if you have modified the .centaur file yourself.

Usage: sudo centaur install [PACKAGE] no_hash_check

Uninstall

Usage: sudo centaur uninstall [PACKAGE]

This will uninstall the specified package by running the relevant uninstall script and removing package from the database. It will check if the package has a parent still installed (i.e. is a dependency of a package).

Force uninstall

Usage: sudo centaur uninstall [PACKAGE] force

This will force uninstall the specified package and is generally not recommended. It's best use is to try and uninstall a package if the install fails halfway and it cannot be recovered and/or normal uninstall is confused. It will not check for dependency conflicts.

Clean

Usage: sudo centaur clean

This will uninstall all unused dependencies leftover from previous packages. Requires root.

Sync

Usage: sudo centaur sync

This will update the package script database. Equivalent to emerge --sync or apt update

List

Usage: centaur list

Does not need root privileges. Lists all packages that have been installed (by centaur).

License

Usage: centaur license

Does not need root privileges. Prints a small version of the GNU GPL V3 license.

Clone this wiki locally