Connect to a Pydio Cells server using the command line



This command line client allows interacting with a Pydio Cells server via the command line. It uses the Cells SDK for Go and the REST API under the hood.

See the respective help pages of the various commands to get detailed explanation and some examples.

WARNING: cec v4 only supports remote servers that are in v4 or newer.


For the very first run, use './cec config add' to begin the command-line based configuration wizard. This will guide you through a quick procedure to get you up and ready in no time.

Non-sensitive information are stored by default in a config.json file under /home/teamcity/.config/pydio/cells-client You can change this location by using the --config flag. Entered (or retrieved, in the case of OAuth2 procedure) credentials will be stored in your keyring.

[Note]: if no keyring is found, all information are stored in clear text in the config.json file, including sensitive bits.


All the command flags documented below are mapped to their associated ENV var, using upper case and CEC_ prefix.

For example: $ ./cec ls --no_cache is equivalent to: $ export CEC_NO_CACHE=true; ./cec ls

This is typically useful when using the Cells Client non-interactively on a server: $ export CEC_URL=https://files.example.com; export CEC_TOKEN=; $ ./cec ls

./cec [flags]


      --config string     Location of Cells Client's config files (default: /home/teamcity/.config/pydio/cells-client/config.json)
  -h, --help              help for ./cec
      --login string      The user login, for Client auth only
      --no_cache          Force token refresh at each call. This might slow down scripts with many calls
      --password string   The user password, for Client auth only
      --skip_keyring      Explicitly tell the tool to *NOT* try to use a keyring, even if present. Warning: sensitive information will be stored in clear text
      --skip_verify       By default the Cells Client verifies the validity of TLS certificates for each communication. This option skips TLS certificate verification
  -t, --token string      A valid Personal Access Token (PAT)
  -u, --url string        The full URL of the target server


Auto generated by Cells Client v4.1.0 on 21-Feb-2024
Back to top