Installation instructions

README.md - Installation

Quickstart

• Download (either .zip or tar.gz)
• extract the archive
• run the file ./place_files_onto_system.sh as root to install Adsorber
• run adsorber enable

Note for updaters from v1.0.0:

All your Adsorber config files will be overwritten by place_files_onto_system.sh.
If you want to keep them, take a copy and restore them afterwards.

Changes

• New aliases for operations, similar to Systemd's service usage.
  Makes the commands hopefully less confusing. Old operations will continue to work.

  • setup = enable
  • update = start
  • restore = stop

  Thanks to @eksperimental for #22

• Update Systemd unit file to not use obsolete logging target
  Thanks to @tongtanhieu for #21

• Fix Systemd Service Log not displaying run date correctly

• Some other minor improvements

Installation instructions

README.md - Installation

Quickstart

• Download (either .zip or tar.gz)
• extract the archive
• run the file ./place_files_onto_system.sh as root to install Adsorber
• run adsorber setup

Note for updaters:

• Due to changes how we handle the hosts file you'll need to remove/disable Adsorber prior upgrading to this version.
  This can be done with either running adsorber disable or ./remove_files_from_system.sh
• All your config files will be overwritten by ./place_files_onto_system.sh.
  If you want to keep them, take a copy and restore them afterwards.
  In most cases the config can be found at /usr/local/etc/adsorber/

Changes

• Adsorber will now manipulate the hosts file inline for increased compatibility, instead of completely overwriting it (see #14 for the discussion). Thanks to @eksperimental
  Therefore you can now directly edit your /etc/hosts without the need to worry that they will be wiped when Adsorber runs.
• /etc/hosts.original will not be read by Adsorber anymore, write your changes directly to the /etc/hosts
• Some minor internal improvements (e.g syntax, etc)

Quickstart

• Download (either .zip or .tar.gz)
• extract the archive
• run the file place_files_onto_system.sh as root to install Adsorber
• run adsorber setup

Note for updaters:

All your config files will be overwritten by place_files_onto_system.sh.
If you want to keep them, take a copy and restore them afterwards.

Changes

• Schedulers now write their output to /var/log/adsorber.log and to syslog
• Fixed ignore_download_error option broken when blacklist was set (see #11). Thanks to @rhtenhove

Quickstart

Download (either .zip or .tar.gz), extract and run place_files_onto_system.sh as root user to install Adsorber to the system or run portable_adsorber.sh to keep it 'portable'.

After installing Adsorber to the system you may want to run adsorber setup to finish the setup, e.g. backing the original hosts file up, fetching ad-domains etc.

Changes

• Added interactive selection of frequency to use with a scheduler
• Added scheduler functionality that writes to syslog,
  you can examine it with grep Adsorber /var/log/syslog
• Many bug fixes and more improvments

Quickstart

Download (either .zip or .tar.gz), extract and run install_to_system.sh as root user to install Adsorber to the system or run portable_adsorber.sh to keep it 'portable'.

Note: After installing Adsorber to the system you may want to run adsorber install to finish the setup, e.g. backing the original hosts file up, fetching ad-domains etc.

Changes

• Installation to system
• Improved error handling
• Improved clean up after specific operation
• Many bug fixes and more improvments

Quickstart

To update run git pull (only if repository was cloned).
Or download (either .zip or .tar.gz), extract and run adsorber.sh as root user:
sudo ./adsorber.sh

Changes

• POSIX compliant - Adsorber can now run on most shells! (bash, sh, ksh, fish ...)
• Revert to the last applied hosts file with adsorber.sh revert
• and many more improvements

Quickstart

To update run git pull.
Download (either .zip or .tar.gz), extract and run adsorber.sh as root user:
sudo ./adsorber.sh

Changes

• Added proxy setting ( in adsorber.conf)
• Fixed IGNORE_DOWNLOAD_ERROR was opposite to the defined setting
• Some other minor improvements

Quickstart

To update run git pull.

Download (either .zip or .tar.gz), extract and run adsorber.sh as root user.

Changes:

• Added colourful output to the terminal 🎨
• Added option to exit if at-least one hosts source couldn't be reached
• Added warning for duplicate option
• Improved error messages
• Improved speed of script by removing unnecessary actions
• Fixed a few issues

Second update, more is planned and more will come.

Quickstart

Download (either .zip or .tar.gz), extract and run adsorber.sh as root user.

Changes:

• Added whitelist functionality
• Added blacklist functionality
• Added install/remove functionality
• Added cronjob support for automatic update
• Added systemd support for automatic update
• Added configuration file (adsorber.conf)

This is the first release, more to come.