Update CloudronManifest.json and documentation files

INSTALL.md

@@ -30,8 +30,8 @@ This guide explains how to install the Elasticsearch package on your Cloudron in
 After installation:
 
 1. Check the app logs to ensure Elasticsearch has started correctly
-2. Update the default password in the app's environment settings
-3. Configure your other Cloudron apps to connect to Elasticsearch using `localhost:9200`
+2. Note the generated password from the logs or from `/app/data/credentials.txt`
+3. Configure your other Cloudron apps to connect to Elasticsearch using the format: `http://elastic:<password>@localhost:9200`
 
 ## Troubleshooting
 
@@ -41,4 +41,137 @@ After installation:
 
 ## Support
 
-For support, please create an issue on the package's GitHub repository or contact the package maintainer. 
+For support, please create an issue on the package's GitHub repository or contact the package maintainer. 
+
+## Integration with Nextcloud
+
+If you want to use this Elasticsearch package with Nextcloud's Full-Text Search functionality, follow these steps:
+
+### Prerequisites
+
+1. Ensure you have the following Nextcloud apps installed:
+   - Full-Text Search
+   - Full-Text Search - Elasticsearch Platform
+   - Any content provider app (e.g., Full-Text Search - Files)
+
+### Configuration Steps
+
+#### 1. Find Your Elasticsearch Password
+
+Check the Elasticsearch app logs to find the generated password:
+
+```bash
+# From the Cloudron dashboard, view the Elasticsearch app logs
+# Look for lines containing "Password: " after Elasticsearch has started
+# Or check the file at /app/data/credentials.txt within the container
+```
+
+#### 2. Create Elasticsearch Index (Optional)
+
+You can manually create an Elasticsearch index using curl:
+
+```bash
+# Connect using localhost (from within another Cloudron app)
+curl -X PUT "http://elastic:<your-password>@localhost:9200/nextcloud"
+```
+
+This creates an index named "nextcloud" that will be used for Nextcloud integration.
+
+For general purposes, you can create other indices as needed:
+
+```bash
+# Create a general-purpose index named "cloud"
+curl -X PUT "http://elastic:<your-password>@localhost:9200/cloud"
+```
+
+You can verify the indices were created successfully with:
+
+```bash
+curl "http://elastic:<your-password>@localhost:9200/_cat/indices"
+```
+
+Alternatively, you can let Nextcloud create and configure the index automatically using the OCC command:
+
+```bash
+cd /app/code
+php occ fulltextsearch_elasticsearch:configure '{"elastic_host":"http://elastic:<your-password>@localhost:9200","elastic_index":"nextcloud"}'
+```
+
+#### 3. Configure Nextcloud
+
+Access the Nextcloud CLI:
+
+```bash
+# From the Cloudron dashboard, click on your Nextcloud app
+# Navigate to "Settings" → "Terminal" to access the CLI
+# Or use the Cloudron CLI command: cloudron exec --app your-nextcloud-app
+```
+
+Run the following commands in the Nextcloud CLI:
+
+```bash
+# Using the OCC command (preferred method)
+cd /app/code
+php occ config:app:set fulltextsearch_elasticsearch allow_self_signed_cert --value=false
+php occ config:app:set fulltextsearch_elasticsearch elastic_ssl --value=false
+```
+
+#### 4. Configure the Elasticsearch Connection
+
+Still in the Nextcloud CLI, configure the Elasticsearch connection:
+
+```bash
+php occ fulltextsearch_elasticsearch:configure '{"elastic_host":"http://elastic:<your-password>@localhost:9200","elastic_index":"nextcloud"}'
+```
+
+Replace `<your-password>` with the password you found in step 1.
+
+#### 5. Initialize the Index
+
+Create and initialize the Elasticsearch index:
+
+```bash
+php occ fulltextsearch:index
+```
+
+For a full reindex of all content, use:
+
+```bash
+php occ fulltextsearch:index -f
+```
+
+#### 6. Test the Configuration
+
+Verify that the connection works:
+
+```bash
+php occ fulltextsearch:test
+```
+
+### Authentication Details
+
+Use the following credentials for Elasticsearch:
+- Username: `elastic`
+- Password: The generated password from `/app/data/credentials.txt`
+
+### Troubleshooting
+
+If you encounter connection errors:
+- Ensure you're using port 9200 (not 9300)
+- Use HTTP instead of HTTPS in the connection URL
+- In Cloudron, use `localhost` instead of IP addresses for app-to-app communication
+- Check that the Elasticsearch app is running
+
+#### Testing Connectivity
+
+You can test connectivity to Elasticsearch from another Cloudron app with:
+
+```bash
+curl -v http://elastic:<your-password>@localhost:9200
+```
+
+If successful, you should see a JSON response with Elasticsearch information.
+
+#### Advanced Configuration
+
+In some cases, you might need to modify additional Elasticsearch settings. You can do this via the elasticsearch.yml file, which is stored in `/app/data/config/elasticsearch.yml` within the Elasticsearch app container.