Plume/docs/CLI.md

2.5 KiB

plm CLI reference

If any required argument is ommitted, you will be asked to input manually.

plm instance

Manage instances.

plm instance new

Create a new local instance.

Example:

plm instance new --private --domain plu.me --name 'My Plume Instance' -l 'CC-BY'

Arguments:

  • --domain, -d: the domain name on which your instance will be available.
  • --name, -n: The name of your instance. It will be displayed on the homepage.
  • --default-license, -l: the license to use for articles written on this instance, if no other license is explicitely specified. Optional, defaults to CC-BY-SA.
  • --private, -p: if this argument is present, registering on this instance won't be possible. Optional, off by default.

Environment variables:

  • BASE_URL will be used as a fallback if --domain is not specified.

plm users

Manage users.

plm users new

Creates a new user on this instance.

Example:

plm users new --admin -n 'kate' -N 'Kate' --bio "I'm Kate." --email 'kate@plu.me'

Arguments:

  • --name, --username, -n: the name of this user. It will be used an human-readable identifier in URLs, for federation and when mentioning this person. It can't be changed afterwards.
  • --display-name, -N: the display name of this user, that will be shown everywhere on the interface.
  • --bio, --biography, -b: the biography of the user. Optional, empty by default.
  • --email, -e: the email adress of the user.
  • --password, -p: the password of the user. You probably want to use this option in shell scipts only, since if you don't specify it, the prompt won't show your password.
  • --admin, -a: makes the user an admin of the instance. Optional, off by default.

Manage full text search index.

plm search init

Initialize the search index.

Example:

plm search init -p Plume'

Arguments:

  • --path, -n: path to plume working directory.
  • --force, -f: override any already existing search index.

plm search refill

Refill the search index.

Example:

plm search refill -p Plume'

Arguments:

  • --path, -n: path to plume working directory.

plm search unlock

Remove lock on the search index, after abnormal termination such as power loss. Only do this if you know no processus is currently using the index.

Example:

plm search unlock -p Plume'

Arguments:

  • --path, -n: path to plume working directory.