Plume/docs/CLI.md

1.7 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.