Skip to content
This repository has been archived by the owner on Aug 15, 2023. It is now read-only.

Latest commit

 

History

History
175 lines (120 loc) · 3.66 KB

INSTALL.md

File metadata and controls

175 lines (120 loc) · 3.66 KB
Raw

How to install easywall

The installation of easywall can be done with the following simple steps.

Please check first whether your operating system is already supported by easywall.

Please read the text carefully to avoid errors.

Check requirements

  • SSH access to the system
  • root access on the system either as user or via sudo

Supported operating systems

We currently only support Debian based operating systems like Debian or Ubuntu.

Install easywall

If the requirements apply to your operating system, you can perform the following installation steps.

Installation by APT Package Manager

  • Install the package requirements for adding a apt repository
apt update
apt install -y apt-transport-https gnupg
  • Add a new repository to APT sources
echo "deb https://apt.wdkro.de/ stable main" > /etc/apt/sources.list.d/easywall.list
  • Import the GPG Key used for signing the release
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 67A12A6883B73731
  • Install the easywall package as other software package
apt update
apt install easywall
  • Optional: Set the username and password for the web interface.
# optional:
# cd /opt/easywall
python3 easywall/web/passwd.py

Installation by Package

wget https://github.com/jpylypiw/easywall/releases/download/vX.X.X/easywall_X.X.X-1_amd64.deb
  • Install the package using Debian Package Manager
dpkg -i easywall_X.X.X-1_amd64.deb
  • Optional: Set the username and password for the web interface.
# optional:
# cd /opt/easywall
python3 easywall/web/passwd.py

Installation by using Git

  • Change to the directory where you want to install easywall. We recommend the directories listed below.
cd /opt
# or
cd /usr/local
  • Clone the easywall installation of GitHub and change to the newly created directory.
git clone https://github.com/jpylypiw/easywall.git
cd easywall
  • To install the easywall core, run the installation script for the core.
# optional:
# cd /opt/easywall
bash scripts/install-core.sh
  • To install the web interface, run the installation script for the web interface.
# optional:
# cd /opt/easywall
bash scripts/install-web.sh
  • Optional: Set the username and password for the web interface.
# optional:
# cd /opt/easywall
python3 easywall/web/passwd.py

Manual installation

  • Change to the directory where you want to install easywall. We recommend the directories listed below.
cd /opt
# or
cd /usr/local
  • Download the latest version of easywall from GitHub
wget https://github.com/jpylypiw/easywall/archive/master.zip
  • Unzip the file and rename the folder. Then change to the newly created directory.
unzip master.zip
mv easywall-master easywall
cd easywall
  • To install the easywall core, run the installation script for the core.
# optional:
# cd /opt/easywall
bash scripts/install-core.sh
  • Optional: To install the web interface, run the installation script for the web interface.
# optional:
# cd /opt/easywall
bash scripts/install-web.sh
  • Optional: Set the username and password for the web interface.
# optional:
# cd /opt/easywall
python3 easywall/web/passwd.py