Files
ente-cloudron/POSTINSTALL.md
Your Name 37cd205a07 Fix Ente Cloudron packaging issues
- Fixed admin-helper.sh to use correct Museum binary path (/app/museum-bin/museum)
- Updated start.sh to handle missing S3 configuration gracefully
  - App now starts in configuration mode when S3 is not configured
  - Shows helpful configuration page instead of failing health checks
  - Properly starts Museum server once S3 is configured
- Updated CloudronManifest.json to version 0.2.2
- All web frontends (photos, accounts, auth, cast, albums, family) verified working
- Museum API server running successfully with S3 storage

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 19:20:15 -06:00

1.5 KiB

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 web terminal.
  3. Edit /app/data/config/s3.env and provide values for all required keys:
    nano /app/data/config/s3.env
    
  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)

Next Steps

  • Visit the app URL and create the first administrator account.
  • Configure the Ente mobile apps to use your custom server (Settings → Advanced → Custom Server).
  • Optional: set the environment variables CLOUDRON_OIDC_IDENTIFIER, CLOUDRON_OIDC_CLIENT_ID, and CLOUDRON_OIDC_CLIENT_SECRET to enable Cloudron SSO in the generated Museum config.

Administration Helpers

  • The Ente CLI binary is shipped at /app/code/ente. Run it via the Cloudron web terminal.
  • CLI configuration lives at /app/data/home/.ente/config.yaml and already points to https://<your-domain>/api.
  • The main Museum configuration is generated at /app/data/museum/configurations/local.yaml. Delete this file to regenerate it with updated environment variables.

Logs are streamed to the Cloudron dashboard. For deeper inspection use:

cloudron logs --app <location> -f