2 files changed, 3 insertions, 2 deletions

diff --git a/support/doc/production.md b/support/doc/production.md
index 4a8c488ee..625e8b26a 100644
--- a/support/doc/production.md
+++ b/support/doc/production.md
@@ -84,7 +84,7 @@ $ cd /var/www/peertube && sudo -u peertube cp peertube-latest/config/production.
 Then edit the `config/production.yaml` file according to your webserver
 configuration.
 
-**PeerTube does not support webserver host change**. Keep in mind your domain name is definitive after your first PeerTube start.
+**PeerTube does not support webserver host change**. Even though [PeerTube CLI can help you to switch hostname](https://docs.joinpeertube.org/#/maintain-tools?id=update-hostjs) there's no official support for that since it is a risky operation that might result in unforeseen errors.
 
 ### Webserver
 
diff --git a/support/doc/tools.md b/support/doc/tools.md
index 6a7d16a3c..62ba52111 100644
--- a/support/doc/tools.md
+++ b/support/doc/tools.md
@@ -302,9 +302,10 @@ $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production
 
 ### update-host.js
 
+**Changing the hostname is unsupported and may be a risky operation, especially if you have already federated.**
 If you started PeerTube with a domain, and then changed it you will have
 invalid torrent files and invalid URLs in your database. To fix this, you have
-to run:
+to run the command below (keep in mind your follower instances will NOT update their URLs).
 
 ```
 $ cd /var/www/peertube/peertube-latest