Merge branch 'main' of https://github.com/Erreur32/nginx-proxy-manager-Bash-API

Author: Erreur32

README.md

@@ -12,7 +12,8 @@
 8. [Examples](#examples)
    - [Info script](#info)
    - [List HOST](#list)
-   - [Enable SSL](#ssl)     
+   - [Enable SSL](#ssl)
+   - [update specific fields of an existing proxy host](#update)  
 12. [Screens](#screens)
 13. [TODO](#todo)
 
@@ -127,7 +128,8 @@ BASE_DIR="/path/nginx_proxy_script/data"
 #   --delete-cert domain                  Delete   certificate for the given domain
 #   --list-access                         List all available access lists (ID and name)
 #   --host-acl-enable id,access_list_id   Enable ACL for a proxy host by ID with an access list ID       
-#   --host-acl-disable id                 Disable ACL for a proxy host by ID   
+#   --host-acl-disable id                 Disable ACL for a proxy host by ID
+#   --update-host id field=value          Modify any field on existing entry host
 #   --help                                Display this help
 
 ```
@@ -161,14 +163,42 @@ BASE_DIR="/path/nginx_proxy_script/data"
 
 ```
 
+#### update      
+##### update specific fields of an existing proxy host
 
-##### Verifying the Configuration
+The `--update-host` command allows you to **update specific fields** of an existing proxy host in Nginx Proxy Manager **without recreating it**.  
 
-######  Info
+Simply specify the **proxy host ID** and the **field you want to update**, like this:
 
-Some info of settings in the script with `./nginx_proxy_manager_cli_.sh --info`
+```bash
+./nginx_proxy_manager_cli.sh --update-host 42 forward_host=new.backend.local
+```
+ 
+| Field Name               | Type      | Description                                                                 |
+|--------------------------|-----------|-----------------------------------------------------------------------------|
+| `domain_names`           | `array`   | List of domains handled by this proxy.                                      |
+| `forward_host`           | `string`  | The destination (backend) hostname or IP.                                   |
+| `forward_port`           | `integer` | The destination port (e.g., `8000`, `443`).                                 |
+| `forward_scheme`         | `string`  | The scheme: `http` or `https`.                                              |
+| `enabled`                | `boolean` | Whether the proxy is enabled (`true` or `false`).                           |
+| `ssl_forced`             | `boolean` | Redirect all HTTP requests to HTTPS.                                        |
+| `certificate_id`         | `integer` | The ID of the SSL certificate to use.                                       |
+| `meta.letsencrypt_agree` | `boolean` | Agree to Let's Encrypt TOS (`true` or `false`).                             |
+| `meta.dns_challenge`     | `boolean` | Use DNS challenge for SSL cert (`true` or `false`).                         |
+| `allow_websocket_upgrade`| `boolean` | Enable WebSocket support (`true` or `false`).                               |
+| `http2_support`          | `boolean` | Enable HTTP/2 (`true` or `false`).                                          |
+| `caching_enabled`        | `boolean` | Enable caching (`true` or `false`).                                         |
+| `block_exploits`         | `boolean` | Block known exploits (`true` or `false`).                                   |
+| `advanced_config`        | `string`  | Custom Nginx directives (multiline string).                                 |
+| `locations`              | `array`   | Custom location blocks (advanced use).                                      |
+
+
+
+#### Verifying the Configuration
 
+Some info of settings in the script with `./nginx_proxy_manager_cli_.sh --info`
 
+#### info
 ```bash
 ./nginx_proxy_manager_cli_.sh --info
 
@@ -186,11 +216,11 @@ Script Variables Information:
 ```
 
 
-**How to activate SSL ?** 
+#### **How to activate SSL ?** 
 
 By following these steps, you can enable SSL for your proxy host for the first time using Let's Encrypt.
 
-##### List
+#### List
  List all Host in one command and show ´id´ , ´status´ and ´SSL´ status:
 
     ./nginx_proxy_manager_cli.sh --host-list
@@ -202,8 +232,8 @@ By following these steps, you can enable SSL for your proxy host for the first t
       3      tutu.fun                              enabled  ✅
 
 
-##### SSL
-Enable SSL for the Host:
+#### ssl
+##### Enable SSL for the Host
 
   Assuming the host ID is *1*, you would enable SSL for the host as follows:
 
@@ -219,11 +249,8 @@ Enable SSL for the Host:
       2      titi.fun                              disable  ✅
       3      tutu.fun                              enabled  ✅
 
- 
- Et Voilà.
-
 
-**Other Exemple command:**
+##### **Other Exemple command:**
 
 
 Host proxy info command `--host-show id`
@@ -293,6 +320,5 @@ Host proxy info command `--host-show id`
 - [x] Add documentation on certain functions
 - [x] ADD: a configuration function for Custom Locations
 - [x] Backup  all settings from NPM
-- [ ] Domain TLS check validity
-- [ ] Better Error Handeling
-- [ ] Restore Function need to be optimized
+- [ ] creation of ACCESS list
+- [ ] Restore Function not work properly , need to find FIX.