summaryrefslogtreecommitdiffstats
path: root/debian/suricata.README.Debian
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 17:39:52 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 17:39:52 +0000
commita95cd20bb8e569c5a5f43808555e90ea436b858f (patch)
tree7fb27265ca110c329d4d42336c979cab09fff04e /debian/suricata.README.Debian
parentAdding upstream version 1:7.0.3. (diff)
downloadsuricata-a95cd20bb8e569c5a5f43808555e90ea436b858f.tar.xz
suricata-a95cd20bb8e569c5a5f43808555e90ea436b858f.zip
Adding debian version 1:7.0.3-1.debian/1%7.0.3-1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/suricata.README.Debian')
-rw-r--r--debian/suricata.README.Debian44
1 files changed, 44 insertions, 0 deletions
diff --git a/debian/suricata.README.Debian b/debian/suricata.README.Debian
new file mode 100644
index 0000000..a1e554a
--- /dev/null
+++ b/debian/suricata.README.Debian
@@ -0,0 +1,44 @@
+Suricata for Debian
+-------------------
+
+The engine is an Open Source Next Generation Intrusion Detection and
+Prevention Tool, not intended to just replace or emulate the existing tools in
+the industry, but to bring new ideas and technologies to the field.
+
+To run the engine with default configuration on interface eth0 (in live mode),
+run the following command (as root):
+ suricata -c /etc/suricata/suricata.yaml -i eth0
+
+To run in live NFQUEUE mode, use (as root):
+ suricata -c /etc/suricata/suricata.yaml -q $QUEUE_ID
+
+You can also run suricata on a PCAP file:
+ suricata -c /etc/suricata/suricata.yaml -r file.pcap
+
+
+Daemon system integration
+-------------------------
+
+The suricata daemon comes preconfigured to run as a system daemon with systemd.
+
+You can start/stop the daemon with:
+ % sudo systemctl start suricata.service
+ % sudo systemctl stop suricata.service
+
+You should copy /lib/systemd/system/suricata.service to
+/etc/systemd/system/suricata.service and adapt the configuration to your needs.
+
+The sysvinit script and related files (/etc/init.d/suricata and
+/etc/default/suricata) will be eventually discarted at some point in the
+future. The /etc/default/suricata file is ignored by the default
+suricata.service file.
+
+By now, there is no integration between suricata and libsystemd (so, options
+like the watchdog are not supported).
+
+
+Updating Rules
+--------------
+
+You should edit /etc/suricata/suricata.yaml and adjust it to fit your needs.
+The recommended way to update rules is via suricata-update (also packaged in Debian).