Document CLI bootstrap steps

This commit is contained in:
Andreas Dueren
2025-11-04 17:49:15 -06:00
parent 5549f03f6e
commit 0652dde795
2 changed files with 32 additions and 5 deletions

View File

@@ -23,13 +23,25 @@ The installer now asks for dedicated hostnames for the Auth/Accounts/Cast/Albums
## Administration
- Use the bundled CLI from the Cloudron web terminal (CLI state lives in `/app/data/cli-data`):
- Use the bundled CLI from the Cloudron web terminal (CLI state lives in `/app/data/cli-data`). On a new deployment initialise it once:
```bash
ente --help
# from the Cloudron terminal, logged in as root
cat <<'EOF' >/cli-data/config.yaml
endpoint:
api: https://<your-app-domain>/api
log:
http: false
EOF
mkdir -p /cli-data/export
chown cloudron:cloudron /cli-data /cli-data/config.yaml /cli-data/export
# List users (requires an existing admin account)
ente admin list-users --admin-user admin@example.com
# store your account (enter the OTP emailed to you)
sudo -u cloudron ente account add
# inspect available commands
sudo -u cloudron ente --help
```
Once the account is added you can follow the upstream admin docs for tasks like whitelisting and quota adjustments.
See the upstream admin guides for further context: [user administration](https://ente.io/help/self-hosting/administration/users) and [CLI reference](https://ente.io/help/self-hosting/administration/cli).
- To persist custom Museum settings (for example, seeding super-admin email addresses), create `/app/data/config/museum.override.yaml`. The file is appended to `museum/configurations/local.yaml` on each startup.