From f4b6faffaa50744f7b745f1ed291f766c60c31e0 Mon Sep 17 00:00:00 2001
From: jasonwitty <jasonpwitty@proton.me>
Date: Fri, 21 Nov 2025 00:41:41 -0800
Subject: [PATCH] Add helpful post-install message to guide users on enabling
 socktop-agent service

---
 socktop_agent/debian/postinst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/socktop_agent/debian/postinst b/socktop_agent/debian/postinst
index 00dbdcc..fcf5e0d 100755
--- a/socktop_agent/debian/postinst
+++ b/socktop_agent/debian/postinst
@@ -23,4 +23,35 @@ chmod 755 /etc/socktop
 
 #DEBHELPER#
 
+# Print helpful message to the user
+cat <<EOF
+
+┌─────────────────────────────────────────────────────────────────────┐
+│ socktop-agent has been installed successfully!                      │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│ The systemd service has been installed but is NOT enabled by       │
+│ default. To enable and start the service:                          │
+│                                                                     │
+│   sudo systemctl enable --now socktop-agent                        │
+│                                                                     │
+│ To start without enabling on boot:                                 │
+│                                                                     │
+│   sudo systemctl start socktop-agent                               │
+│                                                                     │
+│ To check service status:                                           │
+│                                                                     │
+│   sudo systemctl status socktop-agent                              │
+│                                                                     │
+│ Default settings:                                                  │
+│   - Port: 3000 (use -p or --port to change)                       │
+│   - SSL/TLS: disabled (use --enableSSL to enable)                 │
+│                                                                     │
+│ For more information, see:                                         │
+│   /usr/share/doc/socktop_agent/README.md                           │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+
+EOF
+
 exit 0