CLI - Command Line Interface

  1. Using CLI
    1. Using CLI with Docker installation
  2. Users since 1.6.14
    1. List all users
    2. Create a new user
    3. Remove a user
    4. Reset password
    5. Change role

Using CLI

Gancio is distributed with an embedded CLI. To use the CLI you need to specify the config.json configuration file via --config <your_config.json> flag; by default the CLI will look for one in the current directory, so if your current directory is /opt/gancio (having followed the installation instructions) there is no need to specify it.

Using CLI with Docker installation

To use the CLI in a docker installation you can execute a shell inside the container with: docker exec --workdir /home/node/data -it gancio sh and following the normal CLI usage or running commands with:

docker exec --workdir /home/node/data gancio gancio <your command>

(the first “gancio” is the container name)

Users since 1.6.14

All users related sub-commands starts with gancio users. Note that most of this actions could be done from administration panel (Admin > Users).

List all users

To list all users use gancio users list

Create a new user

gancio users create <username|email> [password] [role]

role value could be user (default), admin or editor, you can also specify it using --role flag.
To create an user with administrator privileges use the --role flag, e.g. gancio users create --role admin

Remove a user

gancio users remove <username|email>

Reset password

gancio users reset-password <username|email>

Change role

To add administrator privileges to an user: gancio users set_role <username|email> admin

To remove administrator privileges from an user: gancio users set_role <username|email> user