From 6a72a8fbaf6209f05b82a3eb7c2d2600dbca18c3 Mon Sep 17 00:00:00 2001
From: Timon de Groot <timon.degroot@team.blue>
Date: Fri, 19 Sep 2025 10:38:18 +0200
Subject: [PATCH] Add documentation on enable PHPMyAdmin

---
 .../mysql/how-to-use-phpmyadmin.md            | 33 +++++++++++++++++++
 ...to-use-the-hypernode-systemctl-cli-tool.md |  1 +
 2 files changed, 34 insertions(+)

diff --git a/docs/hypernode-platform/mysql/how-to-use-phpmyadmin.md b/docs/hypernode-platform/mysql/how-to-use-phpmyadmin.md
index a375ce46..e4d32706 100644
--- a/docs/hypernode-platform/mysql/how-to-use-phpmyadmin.md
+++ b/docs/hypernode-platform/mysql/how-to-use-phpmyadmin.md
@@ -21,6 +21,39 @@ This article will explain how you can use PHPMyAdmin and how to create a databas
 
 PHPMyAdmin comes preinstalled on your Hypernode at <http://example.hypernode.io/phpmyadmin/>. In order to reduce brute force attacks, it is not accessible via any other domains names linked to your Hypernode.
 
+### Enabling PHPMyAdmin
+
+By default, PHPMyAdmin is disabled. You can enable it by:
+
+1. Enabling the PHPMyAdmin feature
+1. Adding an allowlist entry
+
+This can be done in both the Control Panel and the CLI.
+
+#### Enabling PHPMyAdmin in the Control Panel
+
+To enable PHPMyAdmin in the Control Panel, go to [the Control Panel](https://my.hypernode.com) and follow the steps below:
+
+1. Go to Settings and open the Security tab.
+1. Enable the **Enable PHPMyAdmin** option.
+1. Click **Save changes**.
+1. Go to **Allowlist**.
+1. Choose **phpmyadmin** as rule type.
+1. Enter an IP address.
+1. Enter a description.
+1. Click **Add allowlist rule**.
+
+It takes a few minutes for the changes to be applied.
+
+#### Enabling PHPMyAdmin in the CLI
+
+To enable PHPMyAdmin in the CLI, log in to your Hypernode over SSH and run the following commands:
+
+```console
+app@abcdef-example-magweb-cmbl:~$ hypernode-systemctl settings phpmyadmin_enabled True
+app@abcdef-example-magweb-cmbl:~$ hypernode-systemctl whitelist add phpmyadmin 1.2.3.4 --description 'Example entry'
+```
+
 ### Credentials
 
 PHPMyAdmin uses the same user and password your database uses. You can find them safely stored on your hypernode in `/data/web/.my.cnf`.
diff --git a/docs/hypernode-platform/tools/how-to-use-the-hypernode-systemctl-cli-tool.md b/docs/hypernode-platform/tools/how-to-use-the-hypernode-systemctl-cli-tool.md
index 432f4ef4..428922fe 100644
--- a/docs/hypernode-platform/tools/how-to-use-the-hypernode-systemctl-cli-tool.md
+++ b/docs/hypernode-platform/tools/how-to-use-the-hypernode-systemctl-cli-tool.md
@@ -58,6 +58,7 @@ To see which values you can set and which values they are allowed to have take a
 | **php_legacy_serialize_precision_enabled**<br/><sub></sub>                                                                                                      | True          | True, False                                                                                                                                 |
 | **php_version**<br/><sub>Change the PHP version</sub>                                                                                                           | 8.3           | 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4                                                                                       |
 | **php_xdebug_enabled**<br/><sub>Enable Xdebug for remote debugging</sub>                                                                                        | False         | True, False                                                                                                                                 |
+| **phpmyadmin_enabled**<br/><sub>Enable PHPMyAdmin</sub>                                                                                                         | False         | True, False                                                                                                                                 |
 | **rabbitmq_delayed_message_exchange_enabled**<br/><sub></sub>                                                                                                   | False         | True, False                                                                                                                                 |
 | **rabbitmq_enabled**<br/><sub>A popular open source message broker</sub>                                                                                        | False         | True, False                                                                                                                                 |
 | **redis_eviction_policy**<br/><sub></sub>                                                                                                                       | volatile-lru  | noeviction<br />allkeys-lru<br />allkeys-lfu<br />volatile-lru<br />volatile-lfu<br />allkeys-random<br />volatile-random<br />volatile-ttl |