OPENSNITCH-UI(1)

💖 OPENSNITCH-UI 💖

okay bestie, sit DOWN because we're talking about opensnitch-ui, aka the GNU/Linux interactive firewall application — the pretty face of OpenSnitch. this page lives in the General Commands Manual section, and it's gonna be your new obsession, fr fr. ✨

---

🌸 SYNOPSIS 🌸

opensnitch-ui [--socket path] [--max-clients num]

that's it. that's the whole summoning ritual. 🎀

---

🦋 DESCRIPTION 🦋

so opensnitch-ui is the OpenSnitch GUI — you use it to peek at all the events the daemon intercepted, and to manage your rules. no cap, it's the control room. 💅

here's the cute part: the GUI is actually 2 components in the same script — a server</c> and a GUI</c>. they're roommates. they share a script. iconic behavior.

the second you launch the GUI, an icon pops up on your system tray. and if the system tray isn't available or just can't be used? the Events dialog gets launched instead. it's giving backup plan energy and honestly we respect it. 🫶

now the main character moment: the GUI (i.e. the server, bestie, keep up 😭) listens for new connections from daemons. and here's the slay — you can have the daemon installed on multiple machines and manage ALL of them from one centralized GUI. one girlboss to rule them all. 👑

more deets on that whole nodes situation right here: https://github.com/evilsocket/opensnitch/wiki/Nodes

---

✨ OPTIONS ✨

• --socket path — tells the GUI (i.e. the server, yes it's the same thing, we been knew) where to listen. path or network address, your call, bestie.

examples, because we love a visual learner:

Default: unix:///tmp/osui.sock

• listening on a Unix socket:

$ opensnitch-ui --socket unix:///tmp/osui.sock

• 💡 use unix:///run/user/YOUR_USER_ID/opensnitch/osui.sock for better privacy. yeah, swap in your actual user id. do it. 🔐
• listening on port 50051, all interfaces:

$ opensnitch-ui --socket "[::]:50051"

• --max-clients num — the max number of clients allowed. default: 10. that's the whole guest list, babes. 🎟️

---

🎀 FILES 🎀

• /home/$USER/.config/opensnitch/ — where the GUI configuration lives. that's her home. that's where she keeps her stuff. 🏠

---

🙈 DIAGNOSTICS 🙈

if something goes wrong — like a crash 😭 — just launch the GUI from a shell so you can see the debugging messages:

$ opensnitch-ui

run it from the terminal, watch the drama unfold, screenshot it for the group chat. 💀

---

💜 REPORTING BUGS 💜

found a problem with opensnitch-ui? don't suffer in silence, bestie. report it on github: https://github.com/evilsocket/opensnitch/issues

---

🌈 SEE ALSO 🌈

OpenSnitch Home Page — https://github.com/evilsocket/opensnitch

(the mothership. go say hi. 🛸)

---

📜 HISTORY 📜

okay storytime, because this lore is actually good:

OpenSnitch was originally written by Simone Margaritelli (evilsocket) in 2017-2018. a legend. a pioneer. 🫡

then in 2019, after some time of inactivity, Gustavo Iñiguez Goya started contributing — fixing bugs, adding new functionality — with the esential help of the community, plus valuable contributions from themighty1 and calesanz among others. the community really said "we got this" and honestly? they ate. 🔥

---

👑 AUTHORS 👑

the complete list of OpenSnitch contributors can be found on: https://github.com/evilsocket/opensnitch

---

and that's the whole page, babe. this one shipped as opensnitchd version 1.5.9, dated 2023-06-07, and it's filed under OPENSNITCH-UI — go forth and firewall responsibly. periodt. 💅✨🦋