docs: Add article on firewalld #612
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Signed-off-by: Evan Maddock <[email protected]>
deoxys94
suggested changes
Apr 20, 2025
|
|
||
| firewalld provides a dynamically managed firewall with support for network or firewall zones to define the trust level of network connections or interfaces. It has support for IPv4, IPv6 firewall settings, and for Ethernet bridges, and a separation of runtime and permanent configuration options. It also provides an interface for services or applications to add `iptables` and `nftables` rules directly. | ||
|
|
||
| ## Firewalld on Solus |
There was a problem hiding this comment.
Suggested change
| ## Firewalld on Solus | |
| ## Install firewalld |
|
|
||
| ### Starting and stopping firewalld | ||
|
|
||
| Please note that firewalld does NOT run on system boot by default. It needs to be manually started/configured to start automatically: |
There was a problem hiding this comment.
- Wrap this in a
:::warning[Important]admonition - Don't use 'please note'.
- No need to capitalize "not", the admonition is enough to draw attention to this. If you really want to highlight this, you can use italics.
- Instead of saying 'it needs', it's better to say "You need to..."
| - `firewalld-config`: A graphical configuration program to configure your firewall setup. | ||
| - `firewalld-applet`: A system tray icon to show the current firewall status. It works with any desktop that supports a system tray via StatusNotifier. | ||
|
|
||
| ### Configuring firewalld |
There was a problem hiding this comment.
No need to make this a subsection of the previous one
Suggested change
| ### Configuring firewalld | |
| ## Configure firewalld |
| | firewalld | `/usr/share/defaults/etc/firewalld/firewalld.conf` | | ||
| | firewalld-applet | `/usr/share/defaults/etc/firewall/applet.conf` | | ||
|
|
||
| To modify the firewall configuration manually, copy the default file to `/etc/firewalld/firewalld.conf` or `/etc/firewall/applet.conf`, and make your changes. If you want to use a graphical tool, install the `firewalld-config` package, and search for Firewall in your desktop's applications menu, or run `firewall-config` from the command line. |
There was a problem hiding this comment.
I think it would be helpful to have the instructions to use the graphical tool separate from the ones to do everything "manually"
github-project-automation
bot
moved this from Backlog
to Under Review
in Web and Documentation
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Adds an article on
firewalld, including configuration and starting and stopping the process.**Note: Once getsolus/packages#5384 is merged, the
$SYNC_DATEplaceholder I put in this page will be updated to the date of that week's sync.