bgpblist/INSTALL.md
2024-07-17 22:27:46 +00:00

1.9 KiB

Installation

Prerequisites to install

This daemon needs PHP, tested with 5.6, 7.4 and 8.2. On Ubuntu/Debian it is installed by:

apt-get -y install php-cli

It may work with other version or it may not ;)

It needs php-cli residing in /usr/bin/php. You can check it by running:

/usr/bin/php -v

Also needs the "pcntl" PHP extension, check it by running:

php -i | grep "pcntl support"

On Linux it needs the "iproute2" package, check it by running:

ip route show

Quick and fast install

git clone https://git.funil.de/sinuspl/bgpblist /opt/bgpblist
cp /opt/bgpblist/etc/default/config.ini /opt/bgpblist/etc/config.ini
cp /opt/bgpblist/etc/systemd/bgpblacklist.service /etc/systemd/system/bgpblacklist.service
systemctl daemon-reload
systemctl enable bgpblacklist.service
systemctl start bgpblacklist.service

Long install with config

First, checkout the repository:

git clone https://git.funil.de/sinuspl/bgpblist /opt/bgpblist

Copy the default config to create your own:

cp /opt/bgpblist/etc/default/config.ini /opt/bgpblist/etc/config.ini

Edit the config.ini, if you are a customer:

vim /opt/bgpblist/etc/config.ini

If not, dont't edit, it will use the defaults. Edit it, particulary, when you habe an user uuid from the site.
Default is "00000000-0000-0000-0000-000000000000" and it gets all feeds by default without any registration.

Copy the systemd unit file:

cp /opt/bgpblist/etc/systemd/bgpblacklist.service /etc/systemd/system/bgpblacklist.service

Reload the systemd:

systemctl daemon-reload

Enable the unit:

systemctl enable bgpblacklist.service

Start the daemon:

systemctl start bgpblacklist.service

Init and not systemd

There is also an Init version of the script

ln -s /opt/bgpblist/etc/init.d/bgpblacklist /etc/init.d/bgpblacklist

Use your system's way to enable that, e.g. with "update-rc.d"