Ente CLI

This page covers the previous CLI. For the current CLI, see Troubleshooting. To switch versions, follow Migration.

Secrets

Ente CLI makes use of your system keyring for storing sensitive information such as passwords.

There are 2 ways to address keyring-related errors:

Install system keyring

This is the recommended method as it is considerably more secure than the latter.

If you are using Linux for accessing Ente CLI with, you can install a system keyring manager such as gnome-keyring, kwallet, etc. via your distribution's package manager.

For Ubuntu/Debian based distributions, you can install gnome-keyring via apt

sudo apt install gnome-keyring

Now you can use Ente CLI for adding an account, which will trigger your system's keyring.

Configure secrets path

In case of using Ente CLI in a server environment, you may not be able to install a system keyring manager. In such cases, you can configure Ente CLI to use a text file for saving the secrets.

Set ENTE_CLI_SECRETS_PATH environment variable in your shell's configuration file (~/.bashrc, ~/.zshrc, or other corresponding file)

# Replace ./secrets.txt with the path to secrets file
# that you are using for saving.
# IMPORTANT: Make sure it is stored in a secure place.
export ENTE_CLI_SECRETS_PATH=./secrets.txt

When you run Ente CLI, and if the file doesn't exist, Ente CLI will create it and fill it with a random 32 character encryption key.

If you create the file, please fill it with a cryptographically generated 32 byte string.