https://github.com/manatools/manafirewall

manatools firewalld configuration tool
https://github.com/manatools/manafirewall

fedora firewalld firewalld-configuration mageia python3

Last synced: about 2 months ago
JSON representation

manatools firewalld configuration tool

• Host: GitHub
• URL: https://github.com/manatools/manafirewall
• Owner: manatools
• License: gpl-2.0
• Created: 2019-02-26T22:44:53.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2025-05-25T05:47:01.000Z (about 1 year ago)
• Last Synced: 2025-05-25T06:33:58.379Z (about 1 year ago)
• Topics: fedora, firewalld, firewalld-configuration, mageia, python3
• Language: Python
• Size: 1.12 MB
• Stars: 12
• Watchers: 6
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

          
# mana firewall #

| | |

|-|-|

|![logo](https://raw.githubusercontent.com/manatools/manafirewall/master/share/images/256x256/manafirewall.png "ManaTools Firewall")| This is the graphical configuration tool for firewalld based on python manatools and libYui (Suse widget abstraction library), to be run using QT, Gtk or ncurses interface.|

| | |

Example with Qt:

![manafirewall with Qt UI](screenshots/manafirewall-Runtime_zone_services-qt.png "manafirewall with Qt UI")

Example with GtK:

![manafirewall with GtK UI](screenshots/manafirewall-Runtime_zone_services-gtk.png "manafirewall with GtK UI")

Example with ncurses:

![manafirewall with ncurses UI](screenshots/manafirewall-Runtime_zone_services-ncurses.png "manafirewall with ncurses UI")

## REQUIREMENTS

### python3-firewall >= 0.9.0

* https://github.com/firewalld/firewalld

### SUSE libyui >= 4.2.14

* https://github.com/libyui/libyui

* Consider to check some not yet approved changes here https://github.com/anaselli/libyui

### libyui-mga > 1.2.1 - our widget extension

* https://github.com/manatools/libyui-mga

### SUSE libyui-bindings (included into libyui)

* https://github.com/libyui/libyui-bindings

  At the moment add patch from anaselli branch to manage new libyui-mga 1.1.0 at

  https://github.com/libyui/libyui-bindings/pull/35

### at least one of the SUSE libyui plugins

* libyui-gtk     - https://github.com/libyui/libyui-gtk

* libyui-ncurses - https://github.com/libyui/libyui

* libyui-qt      - https://github.com/libyui/libyui

* Consider here also to check some not yet approved changes at

  https://github.com/anaselli/libyui-XXX forks (where XXX is

  gtk, qt or ncurses)

### at least one of the MGA libyui widget extension plugins (according to the one above)

* libyui-mga-gtk     - https://github.com/manatools/libyui-mga-gtk

* libyui-mga-ncurses - https://github.com/manatools/libyui-mga-ncurses

* libyui-mga-qt      - https://github.com/manatools/libyui-mga-qt

### python-manatools

* https://github.com/manatools/python-manatools

## INSTALLATION

### Distribution packages:

* Mageia:

    * manafirewall: `dnf install manafirewall` or `urpmi manafirewall`

    * manafirewall-gui: `dnf install manafirewall-` or `urpmi manafirewall-`

        * Replace `` with `qt` or `gtk` depending on desired toolkit

* Fedora:

    * manafirewall:     `dnf install manafirewall`     (installs all needed for use on terminal)

    * manafirewall-gui: `dnf install manafirewall-gui` (installs all needed for use in desktop environment)

### From sources:

* Packages needed to build:

    * cmake >= 3.4.0

    * python3-devel >= 3.4.0

    * optional: gettext        (for locales)

* Configure: `mkdir build && cd build && cmake ..`

    * -DCMAKE_INSTALL_PREFIX=/usr      - Sets the install path, eg. /usr, /usr/local or /opt

    * -DCHECK_RUNTIME_DEPENDENCIES=ON  - Checks if the needed runtime dependencies are met.

* Build:     `make`

* Install:   `make install`

* Run:       `manafirewall`

### From sources (for developers and testers only):

* Packages needed to build:

    * cmake >= 3.4.0

    * python3-devel >= 3.4.0

    * python3-virtualenv

    * optional: gettext        (for locales)

* Setup your virtual environment

    * cd $MANAFIREWALL_PROJ_DIR               # MANAFIREWALL_PROJ_DIR is the manafirewall project directory

    * virtualenv --system-site-packages venv  # create virtual environment under venv directory

    * . venv/bin/activate                     # activate virtual environment

* Configure: `mkdir build && cd build && cmake -D... .. && make install`

    * needed cmake options are

        * -DCMAKE_INSTALL_PREFIX=$MANAFIREWALL_PROJ_DIR/venv              - venv install prefix

        * -DCMAKE_INSTALL_FULL_SYSCONFDIR=$MANAFIREWALL_PROJ_DIR/venv/etc - venv sysconfig directory

    * useful cmake options are

        * -DCHECK_RUNTIME_DEPENDENCIES=ON  - Checks if the needed runtime dependencies are met.

* Run: `manafirewall` into virtual environment, add '--locales-dir' option if you want to test localization locally)

    * useful manafirewall options are

        * --locales-dir         - if you want to test localization locally

        * --images-path         - local icons and images (set to $MANAFIREWALL_PROJ_DIR/venv/share/manafirewall/images/)

## CONTRIBUTE

Manatools and manafirewall developers as well as some users or contributors are on IRC. They often discuss development issues there

and that to have imeediate feedbacks and ideas. The Freenode IRC channel is **#manatools**, get in touch with us.

If you have any issues or ideas add or comment an [issue](https://github.com/manatools/manafirewall/issues).

Check also into our [TODO](TODO.md) file.

## LICENSE AND COPYRIGHT

See [license](LICENSE) file.