Command line interface¶

Matchbox comes with a command line interface (CLI) that allows users to perform certain management tasks.

To run the CLI:

mbx [OPTIONS] COMMAND [ARGS]

To get help:

mbx --help

To get help on specific commands:

mbx COMMAND --help

How do I?¶

Bootstrap Matchbox¶

The first user is always the system admin. As soon as you run the server for the first time, log in to automatically be added to the admins group.

mbx login

Manage permissions¶

Permissions are defined between groups and resources. To manage groups:

mbx groups

For example, to manage permissions on a collection resource, see its related commands:

mbx collections -c COLLECTION permissions
mbx collections -c COLLECTION grant -g GROUP -p PERMISSION
mbx collections -c COLLECTION revoke -g GROUP -p PERMISSION

See permissions for more information.

Delete orphans¶

When steps are modified or deleted, the database can end up with clusters that are not related to any source, model, resolver, or evaluation data. These clusters are orphaned and should be deleted regularly to reduce bloat.

mbx admin prune

This command will print the number of orphaned clusters deleted.