Skip to content

Latest commit

 

History

History
107 lines (83 loc) · 4.63 KB

README.md

File metadata and controls

107 lines (83 loc) · 4.63 KB

mana firewall

logo 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

Example with GtK: manafirewall with GtK UI

Example with ncurses: manafirewall with ncurses UI

REQUIREMENTS

python3-firewall >= 0.9.0

SUSE libyui >= 4.2.14

libyui-mga > 1.2.1 - our widget extension

SUSE libyui-bindings (included into libyui)

at least one of the SUSE libyui plugins

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

python-manatools

INSTALLATION

Distribution packages:

  • Mageia:
    • manafirewall: dnf install manafirewall or urpmi manafirewall
    • manafirewall-gui: dnf install manafirewall-<gui> or urpmi manafirewall-<gui>
      • Replace <gui> 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.

Check also into our TODO file.

LICENSE AND COPYRIGHT

See license file.