Command Line

ClusterCockpit Command Line Options

This page describes the command line options for the cc-backend executable.


-add-user <username>:[admin,support,manager,api,user]:<password>

Function: Add a new user. Only one role can be assigned.

Example: -add-user abcduser:manager:somepass


  -apply-tags

Function: Run taggers on all completed jobs and exit.


  -config <path>

Function: Specify alternative path to config.json.

Default: ./config.json

Example: -config ./configfiles/configuration.json


  -del-user <username>

Function: Remove an existing user.

Example: -del-user abcduser


  -dev

Function: Enable development components: GraphQL Playground and Swagger UI.


  -force-db

Function: Force database version, clear dirty flag and exit.


  -gops

Function: Listen via github.com/google/gops/agent (for debugging).


  -import-job <path-to-meta.json>:<path-to-data.json>, ...

Function: Import a job. Argument format: <path-to-meta.json>:<path-to-data.json>,...

Example: -import-job ./to-import/job1-meta.json:./to-import/job1-data.json,./to-import/job2-meta.json:./to-import/job2-data.json


  -init

Function: Setup var directory, initialize sqlite database file, config.json and .env.


  -init-db

Function: Go through job-archive and re-initialize the job, tag, and jobtag tables (all running jobs will be lost!).


  -jwt <username>

Function: Generate and print a JWT for the user specified by its username.

Example: -jwt abcduser


  -logdate

Function: Set this flag to add date and time to log messages.


  -loglevel <level>

Function: Sets the logging level.

Arguments: debug | info | warn | err | crit

Default: warn

Example: -loglevel debug


  -migrate-db

Function: Migrate database to supported version and exit.


  -revert-db

Function: Migrate database to previous version and exit.


  -server

Function: Start a server, continues listening on port after initialization and argument handling.


  -sync-ldap

Function: Sync the hpc_user table with ldap.


  -version

Function: Show version information and exit.