Update Cloudron app configuration and setup
This commit is contained in:
36
README.md
36
README.md
@@ -10,6 +10,28 @@ This repository contains the Cloudron packaging for [Ente](https://ente.io), an
|
||||
- Configured to use Cloudron's mail service for sending emails
|
||||
- Easy to deploy and manage through the Cloudron interface
|
||||
|
||||
## Requirements
|
||||
|
||||
### Browser Compatibility
|
||||
|
||||
Ente uses modern web technologies for its end-to-end encryption:
|
||||
|
||||
- **WebAssembly**: Required for cryptographic operations
|
||||
- **IndexedDB**: Required for client-side data storage
|
||||
|
||||
Most modern browsers support these features, but they may be blocked by:
|
||||
- Browser privacy settings
|
||||
- Content Security Policies
|
||||
- Certain browser extensions
|
||||
|
||||
This package includes custom Caddy configuration with appropriate security headers to ensure these features work correctly.
|
||||
|
||||
### S3-Compatible Storage
|
||||
|
||||
Ente requires an S3-compatible object storage service. You can use:
|
||||
- Cloudron's built-in object storage
|
||||
- External services like AWS S3, Wasabi, or MinIO
|
||||
|
||||
## Building and Installing
|
||||
|
||||
### Option 1: Build and Install Manually
|
||||
@@ -53,6 +75,14 @@ The app is configured automatically using Cloudron's environment variables for:
|
||||
- SMTP mail service
|
||||
- App origin URL
|
||||
|
||||
### Additional Configuration
|
||||
|
||||
The package includes several enhancements to ensure proper functionality:
|
||||
|
||||
1. **Security Headers**: Custom Content-Security-Policy headers that allow WebAssembly and IndexedDB
|
||||
2. **API Configuration**: Dynamic runtime configuration to ensure the frontend connects to the correct API endpoint
|
||||
3. **CORS Headers**: Proper CORS configuration for API access
|
||||
|
||||
## Usage
|
||||
|
||||
### Web Client
|
||||
@@ -77,6 +107,12 @@ cloudron update --app ente.yourdomain.com
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
1. **"Failed to fetch" errors**: Check if your browser is blocking API requests to your domain
|
||||
2. **WebAssembly errors**: Ensure your browser supports and allows WebAssembly (try using Chrome or Firefox)
|
||||
3. **IndexedDB errors**: Make sure your browser allows IndexedDB (not in private/incognito mode)
|
||||
|
||||
For issues specific to the Cloudron packaging, please open an issue in this repository.
|
||||
|
||||
For issues with Ente itself, please refer to the [main Ente repository](https://github.com/ente-io/ente).
|
||||
|
Reference in New Issue
Block a user