changelog: Otoroshi set domains

Author: davlgd

content/changelog/2025/11-28-otoroshi-set-domains.md

@@ -0,0 +1,27 @@
+---
+title: Set Otoroshi admin and routes domains at creation
+description: You can now set custom domains for Otoroshi admin interface and routes when creating the add-on on Clever Cloud
+date: 2025-12-28
+tags:
+  - addons
+  - otoroshi
+authors:
+  - name: Sébastien Allemand
+    link: https://github.com/allemas
+    image: https://github.com/allemas.png?size=40
+  - name: David Legrand
+    link: https://github.com/davlgd
+    image: https://github.com/davlgd.png?size=40
+excludeSearch: true
+---
+
+When you deploy an Otoroshi add-on on Clever Cloud, you can access its admin interface through a `<random_chars>-otoroshi.services.clever-cloud.com` domain. When you create a new route, it starts with a `app-id.cleverapps.io`. You can now set custom domains at creation through the `base-domain` and `routes-domain` options in Clever Tools:
+
+```bash
+clever addon create otoroshi myOtoroshiName --option base-domain=otoroshi.example.com --option routes-domain=routes.example.com
+```
+
+These domains' DNS configuration needs to point to Clever Cloud's servers. For example, if the Otoroshi add-on is deployed in the `par` (Paris) region, you need to create CNAME records pointing to `domain.par.clever-cloud.com.`.
+
+- [Learn more about Otoroshi on Clever Cloud](/doc/addons/otoroshi/)
+- [Learn more about DNS and custom domains on Clever Cloud](/doc/administrate/domain-names/)

content/doc/addons/otoroshi.md

@@ -55,15 +55,29 @@ An initial account has been created, change the password at first login (Securit
 Learn more about Otoroshi with LLM on Clever Cloud: https://www.clever.cloud/developers/doc/addons/otoroshi/
 ```
 
+By default we use Clever Cloud's domain names for both the admin interface and the routes you'll manage through Otoroshi, but you can set custom domains at creation through the `base-domain` and `routes-domain` options that you can use independently:
+
+```bash
+clever addon create otoroshi myOtoroshiName --option base-domain=otoroshi.example.com
+clever addon create otoroshi myOtoroshiName2 --option routes-domain=routes.example.com
+clever addon create otoroshi myOtoroshiName3 --option base-domain=otoroshi.example.com --option routes-domain=routes.example.com
+```
+
+These domains' DNS configuration needs to point to Clever Cloud's servers. For example, if the Otoroshi add-on is deployed in the `par` (Paris) region, you need to create CNAME records pointing to `domain.par.clever-cloud.com.`.
+
 Refer to the [Clever Tools documentation](/doc/cli/addons/) for more details on add-on management.
 
+> [!TIP] Routes management
+> When you create routes in Otoroshi, they will use the routes domain you set at creation, or `app-id.cleverapps.io`. But you can add as many custom domains as you need on the underlying Java application and use them in Otoroshi routes.
+
 ## Version management
 
 To change the version of an Otoroshi add-on on Clever Cloud, you can use the `CC_OTOROSHI_VERSION` environment variable of its Java Application and rebuild it. But there are various ways to do it simpler with [Clever Tools](/doc/cli/):
 
 ```bash
 # Set a specific supported version at creation
-clever addon create otoroshi --addon-version <version> myOtoroshi
+# You can add options to set base or routes domains if needed
+clever addon create otoroshi myOtoroshi --addon-version <version>
 
 # Enable Operators commands
 clever features enable operators
@@ -81,7 +95,17 @@ clever otoroshi version update myOtoroshi <new_version>
 
 ## Accessing the Otoroshi with LLM interface
 
-Once you created your add-on, open the management URL or look for `CC_OTOROSHI_URL` value in the Otoroshi with LLM dashboard from the Console. The first time you connect, change the initial password (Security -> Administrators -> Edit user).
+Once you created your add-on, open the management URL in the Otoroshi with LLM dashboard from the Console. You can also use Clever Tools to open Java underlying application logs or the Otoroshi web UI directly:
+
+```bash
+# Enable Operators commands
+clever features enable operators
+
+clever otoroshi open logs myOtoroshi
+clever otoroshi open webui myOtoroshi
+```
+
+The first time you connect, change the initial password (Security -> Administrators -> Edit user).
 
 * [Learn how to use Otoroshi](https://maif.github.io/otoroshi/manual/how-to-s/index.html)