openSUSE Build Service

File SUSE.readme of Package pihole

# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation; either version 2.1 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# Copyright (C) 2018 Malcolm Lewis <malcolmlewis@opensuse.org>

# Description: SUSE.readme
# Version: 0.0.2
# Date: 21st September, 2018

SUSE specific setup steps;

1. Start YaST /etc/sysconfig Editor and browse to System -> Pihole ->
   setupVars.conf;
   - Add the IP address(es) and Netmask to be used with pihole
     (eg nnn.nnn.nnn.nnn/24).
   - Modify the interface name (default: eth0).
   - Modify DNS server 1 to use (default: 208.67.222.222 openDNS).
   - Modify DNS server 2 to use (default: 208.67.220.220 openDNS).
   Save changes and exit YaST /etc/sysconfig Editor.

2. Manually update the ad block list by running the command;
   pihole -g

3. Starting pihole systemd service for the first time;
     systemctl start pihole-FTL

   Initial configuration will be run to setup the system and database.
   - To check status;
     systemctl status pihole-FTL
   If all OK system will show as active (exited) and Started pihole-FTL
   daemon.

4. Finish up
   - If pihole-FTL statis is ok, you can enable the pihole-FTL service,
     logrotate and updateGravity (ad list) systemd timers;

        systemctl enable pihole-FTL.service pihole-logrotate.timer pihole-updateGravity.timer

   - Check status of all services;

        systemctl status pihole-FTL.service pihole-logrotate.timer pihole-updateGravity.timer

   - Run the pihole command to see options available

5. Other
   - Web interface (AdminLTE) is not included.
   - Disabled pihole features (options) are reconfigure, admin, updatePihole,
     version, uninstall and checkout.
   - Added pihole feature 'systemd' to show status of FTL, logrotate and updateGravity
     systemd services.
   - Due to the non standard way other distributions determine arm hardware and
     pihole-FTL is running on a Raspberry Pi3 the cpu frequency, temperature etc
     is not displayed when using the chronometer option (this is also designed
     for a LCD), but a good tool for checking status (eg json output).

    ____
  /@    ~-.
  \/ __ .- |
   // //  @  

Have a lot of fun...


### End of SUSE.readme ###
Places

File SUSE.readme of Package pihole

Places
