41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
Your Ente installation is almost ready!
|
|
|
|
## Required: External Object Storage
|
|
|
|
Before using Ente, configure an S3-compatible object storage provider:
|
|
|
|
1. Open the Cloudron dashboard and select your Ente app.
|
|
2. Launch the file explorer.
|
|
3. Open `/app/data/config/s3.env` and provide values for **all** required keys.
|
|
4. Save the file and restart the app from the Cloudron dashboard.
|
|
|
|
Supported variables:
|
|
- `S3_ENDPOINT` (e.g. `https://<account>.r2.cloudflarestorage.com`)
|
|
- `S3_REGION`
|
|
- `S3_BUCKET`
|
|
- `S3_ACCESS_KEY`
|
|
- `S3_SECRET_KEY`
|
|
- `S3_PREFIX` (optional path prefix)
|
|
|
|
## Required: Secondary Hostnames
|
|
|
|
The installer now asks for dedicated hostnames for the Auth/Accounts/Cast/Albums/Family web apps (via Cloudron `httpPorts`). If you manage DNS outside of Cloudron, create CNAME/A records such as `accounts.<app-domain>`, `auth.<app-domain>`, etc., pointing at the primary app domain. With Cloudron-managed DNS the records are created automatically.
|
|
|
|
## Administration
|
|
|
|
- Use the bundled CLI from the Cloudron web terminal (CLI state lives in `/app/data/cli-data`):
|
|
```bash
|
|
ente --help
|
|
|
|
# List users (requires an existing admin account)
|
|
ente admin list-users --admin-user admin@example.com
|
|
```
|
|
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.
|
|
```yaml
|
|
internal:
|
|
super-admins:
|
|
- admin@example.com
|
|
```
|