Create add-custom-services-to-openadmin.md

website/docs/articles/dev-experience/add-custom-services-to-openadmin.md

@@ -0,0 +1,87 @@
+# Add custom services to OpenAdmin
+
+Custom services can be added to OpenAdmin to be run and monitored from the admin panel.
+
+In this example, We will add [netdata](https://learn.netdata.cloud/docs/netdata-agent/installation/docker) docker image.
+
+## Add service
+
+```
+cd /root
+nano docker-compose.yml
+```
+
+and add the netdata section:
+
+```
+  netdata:
+    image: netdata/netdata
+    container_name: netdata
+    pid: host
+    network_mode: host
+    restart: unless-stopped
+    cap_add:
+      - SYS_PTRACE
+      - SYS_ADMIN
+    security_opt:
+      - apparmor:unconfined
+    environment:
+      - DO_NOT_TRACK=1
+      - NETDATA_CLOUD_ENABLE=no
+    volumes:
+      - ./netdata/config:/etc/netdata
+      - ./netdata/lib:/var/lib/netdata
+      - ./netdata/cache:/var/cache/netdata
+      - /:/host/root:ro,rslave
+      - /etc/passwd:/host/etc/passwd:ro
+      - /etc/group:/host/etc/group:ro
+      - /etc/localtime:/etc/localtime:ro
+      - /proc:/host/proc:ro
+      - /sys:/host/sys:ro
+      - /etc/os-release:/host/etc/os-release:ro
+      - /var/log:/host/var/log:ro
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - /run/dbus:/run/dbus:ro
+```
+
+save and exit the file. then start the service:
+
+```
+docker --context=default compose up -d netdata
+```
+
+now, I suggest just whitelisting your IP on the firewall instead of opening the port to the internet.
+
+Then open the IP:19999 in your browser:
+
+![screenshot](https://i.postimg.cc/CFRC5zG9/netdata.png)
+
+
+## Monitor service
+
+Next step is to make the netdata service available from **OpenAdmin > Services** page so we can view its status, start/stop or restart it.
+
+For this, we need to add the netdata service in `/etc/openpanel/openadmin/config/services.json` file:
+
+```
+    {
+        "name": "Netdata",
+        "type": "docker",
+        "on_dashboard": false,
+        "real_name": "netdata"
+    },
+```
+`real_name` is the service/container name, and `name` is the human-readable name displayed in OpenAdmin services.
+
+Save the file and refresh the page in OpenAdmin - service is immeditelly visible and we can start/stop it from the panel.
+
+![services](https://i.postimg.cc/qpTMgY8r/2025-04-30-16-33.png)
+
+We can also receive notifications when the service is not running. For this edit the file: `/etc/openpanel/openadmin/config/notifications.ini` and add service name (`netdata`) under services:
+
+```
+services=panel,admin,caddy,mysql,docker,csf,netdata
+```
+
+save the file and exit. Sentinel service will now also check if the netdata container is running and if not, send alerts to **OpenAdmin > Notifications** and if emails are enabled then to email as well.
+