CyberSecurity Ninjas 网络空间安全忍者

View on GitHub
Home Projects Articles Apophthegm About

Garlic 大蒜 - Intrusion Detection and Prevention System 防御入侵系统 (Personal Computer)


Networks and computers that are opened to the public facing hacker attacks from all over the world every day. Once we are compromised, we would be one of the cyber crime victims. Our tasty Garlic is a high performance and ultra-low latency Intrusion Detection and Prevention System (IDPS). Unlike well known and famous brands for large business enterprises in the market, Garlic is available free of charge that everyone can afford. It is ideal for home, Small Office Home Office (SOHO) and Small Medium Business (SMB).

Not a Network Security Monitoring (NSM) or Information Security (InfoSec) expert? No problem! Our Garlic really is the “Plug, Play and Forget” system of your dreams. Don’t be the next cyber crime victims, try Garlic now!

Garlic is designed by a hacker to defend against hackers. He knows what hackers are doing and thinking, regardless of whether they are ethical or malicious.







Garlic is an Open Source Project which is released under GPLv3 License and it is developed by Samiux.

Please keep in mind that Garlic is available FREE OF CHARGE.

Garlic is designed and developed by Samiux based on Croissants (Croissants since 2012).






1.0 Installation Guide

1.1 Download and Install

sudo -sH

cd /root

sudo apt install git net-tools

git clone

cd /root/garlic

cp -R rules/ /root
cp * /root

cd /root

nano nsm.conf

chmod +x nsm_install

sudo ./nsm_install

Make sure you edit nsm.conf before running nsm_install

1.2 ChangeLog

Garlic ChangeLog

2.0 User Guide

2.1 Glances

Text mode monitoring tool for the performance of Taro.


2.2 Suricata Health Check

sudo tail -f /var/log/suricata/stats.log | grep drop

Press CTRL+c to exit.

2.3 Suricata Event Log

sudo tail -f /var/log/suricata/fast.log

Press CTRL+c to exit.

2.4 Rules Management

If you want to disable some rules as they are false positive, you can edit the “disable.conf” of suricata-update.

sudo nano /etc/suricata/disable.conf

If you want to drop some traffic, you can edit the “drop.conf” of suricata-update.

sudo nano /etc/suricata/drop.conf

If you want to modify some rules, you can edit the “modify.conf” of suricata-update.

sudo nano /etc/suricata/modify.conf

After updated the configuration files, you should run the following command to make the changes effective.

sudo nsm_rules_update

2.5 Ubuntu Update

sudo update_ubuntu

2.6 Auto Configuration

Whenever you changed the nsm.conf file, you need to run the following command in order to make it effective.

sudo nano /etc/croissants/conf.d/nsm.conf

sudo /etc/croissants/conf.d/auto_config

3.0 Hall of Fame


4.0 Troubleshooting

If you cannot access internet when you are behind the Taro, Suricata may be down unexpectedly. You can check if it is running or not by the following command :

sudo ps aux | grep suricata

If it is not running, you can issue the following command to start it :

sudo systemctl restart suricata

You can check the suricata.log at /var/log/suricata/suricata.log. Please allow about 5 minutes for Suricata fully starting.

5.0 Uninstall

sudo -sH
cd /root
chmod +x garlic_uninstaller
sudo ./garlic_uninstaller

Then reboot your personal computer.

6.0 FAQ

(1) When will the rules be updated?

The update will be carried out within 15 minutes when the Garlic is booting up. If you turn off the Garlic within 15 minutes of the booting up, you may also break the system too.

(2) How many detecting / blocking rules in Garlic?

There are more than 40,000 rules in Garlic and they are all free of charge. The number of rules are increasing.

(3) Can Garlic decrypt the SSL/TLS traffic?

Garlic cannot decrypt the SSL/TLS traffic well. However, it can handle a limited SSL/TLS traffic flow. Therefore, it is not ideal for using it as Web Application Firewall (WAF). For example, Garlic can detect and drop self signed SSL/TLS certificate traffic and etc.

(4) How about Garlic is turned off for a week or longer?

It is recommended to run the install script once again to keep the Garlic up-to-date.

7.0 To-Do-List

7.1 Upgrade to Ubuntu Desktop 24.04 LTS


8.0 See Also

Besides, your desktop is required to be hardening on SSH and other applications, etc when necessary. It is because that Garlic is not a silver bullet. Garlic is running behind router or Wifi router as well as Wifi hotpot.

9.0 Bug Fixed


10.0 Known Issues


Home Projects Articles Apophthegm About