Uploaded July 2023 | Updated November 2026, 3 hours ago
#AdGuard #AdBlocker #OpenWRT
Full steps can be found at i12bretro.github.io/tutorials/0442.html
--------------------------------------------------------------------
What is AdGuard Home?
--------------------------------------------------------------------
AdGuard Home is a network-wide software for blocking ads and tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.
It operates as a DNS server that re-routes tracking domains to a “black hole”, thus preventing your devices from connecting to those servers. It's based on software we use for our public AdGuard DNS servers, and both share a lot of code. - github.com/AdguardTeam/AdguardHome
--------------------------------------------------------------------
Installing AdGuard Home
--------------------------------------------------------------------
01. Open a web browser and navigate to the OpenWRT LuCI web UI
02. Log in
03. Select System ≫ Startup in the top navigation menu
04. Find dnsmasq and click the Stop button and click Enabled to disable the service on startup
05. Select System ≫ Software in the top navigation menu
06. Type cert in the search
07. Find ca-certificates and click the Install... button
08. Find ca-bundle and click the Install... button
09. Type libustream in the search
10. Find libustream-openssl and click the Install... button
11. Open another tab and navigate to github.com/AdguardTeam/AdGuardHome/wiki/Getting-Started#installation
12. Find the download for Linux on the architecture of the router (arm32, arm64, etc)
13. Right click the link and Copy shortcut / Copy link address
14. Connect to the OpenWRT device via SSH
15. Run the following commands
# download adguard home, pasting the download link copied above
wget static.adguard.com/adguardhome/release/AdGuardHome_linux_amd64.tar.gz --no-check-certificate
# extract the download tar.gz
tar xfvz AdGuardHome_linux*
# change directory into the extracted folder
cd AdGuardHome
# install AdGuardHome as a service
./AdGuardHome -s install
16. Open a web browser and navigate to http://OpenWRTIP:3000
17. Click the Get Started button
18. Set the Admin Web Interface and DNS Server network interfaces and ports, note port 80 can't be used for the web interface ≫ Click Next
19. Enter an admin username and password ≫ Click Next
20. Click Next on page 4
21. Click Open Dashboard on the Congratutations page
22. Log in using the admin username and password created during the install
23. Welcome to AdGuardHome running on OpenWRT
Source: github.com/AdguardTeam/AdGuardHome#getting-started
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro
#AdGuard #AdBlocker #OpenWRT
Full steps can be found at i12bretro.github.io/tutorials/0442.html
--------------------------------------------------------------------
What is AdGuard Home?
--------------------------------------------------------------------
AdGuard Home is a network-wide software for blocking ads and tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.
It operates as a DNS server that re-routes tracking domains to a “black hole”, thus preventing your devices from connecting to those servers. It's based on software we use for our public AdGuard DNS servers, and both share a lot of code. - github.com/AdguardTeam/AdguardHome
--------------------------------------------------------------------
Installing AdGuard Home
--------------------------------------------------------------------
01. Open a web browser and navigate to the OpenWRT LuCI web UI
02. Log in
03. Select System ≫ Startup in the top navigation menu
04. Find dnsmasq and click the Stop button and click Enabled to disable the service on startup
05. Select System ≫ Software in the top navigation menu
06. Type cert in the search
07. Find ca-certificates and click the Install... button
08. Find ca-bundle and click the Install... button
09. Type libustream in the search
10. Find libustream-openssl and click the Install... button
11. Open another tab and navigate to github.com/AdguardTeam/AdGuardHome/wiki/Getting-Started#installation
12. Find the download for Linux on the architecture of the router (arm32, arm64, etc)
13. Right click the link and Copy shortcut / Copy link address
14. Connect to the OpenWRT device via SSH
15. Run the following commands
# download adguard home, pasting the download link copied above
wget static.adguard.com/adguardhome/release/AdGuardHome_linux_amd64.tar.gz --no-check-certificate
# extract the download tar.gz
tar xfvz AdGuardHome_linux*
# change directory into the extracted folder
cd AdGuardHome
# install AdGuardHome as a service
./AdGuardHome -s install
16. Open a web browser and navigate to http://OpenWRTIP:3000
17. Click the Get Started button
18. Set the Admin Web Interface and DNS Server network interfaces and ports, note port 80 can't be used for the web interface ≫ Click Next
19. Enter an admin username and password ≫ Click Next
20. Click Next on page 4
21. Click Open Dashboard on the Congratutations page
22. Log in using the admin username and password created during the install
23. Welcome to AdGuardHome running on OpenWRT
Source: github.com/AdguardTeam/AdGuardHome#getting-started
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro
![Running a MacOS 14 Sonoma VM in VMware
#MacOS #Sonoma #VMware
Full steps can be found at https://i12bretro.github.io/tutorials/0602.html
Installing and Configuring VMware
💡 NOTE: MacOS higher than version 12 requires a CPU with AVX2 instruction support
01. Download a MacOS Sonoma .iso https://archive.org/search.php?query=MacOS%20Collection&and[]=mediatype%3A%22software%22 OR create your own https://youtu.be/JFMvUpdCMwo
02. Download VMware Workstation Player https://www.vmware.com/products/workstation-player.html
03. Download MacOS Unlocker for VMware Workstation https://github.com/paolo-projects/auto-unlocker/releases
04. Install VMware Workstation Player, accepting the defaults
05. Extract the downloaded MacOS Unlocker for VMware Workstation
06. Inside the extracted file, right click Unlocker.exe ≫ Run as administrator
07. Click the Patch button
08. Wait for patching to complete before continuing
Creating the Sonoma VM
01. Launch VMware Workstation Player
02. Click Continue to use Workstation Player for free for non-commercial use
03. Click Finish
04. Click Create a New Virtual Machine on the right side of the application
05. Select Installer disc image file (iso) ≫ Browse to and select the downloaded MacOS Sonoma .iso ≫ Click Next
06. Select Apple Mac OS X and macOS 13 ≫ Click Next
07. Name the VM MacOS14 and set the path to store the VM files ≫ Click Next
08. Adjust the disk size if necessary ≫ Click Next
09. Click Finish
10. Open File Explorer and navigate to the VM files
11. Edit the .vmx file in a text editor
12. Search for board-id.reflectHost and set the value to FALSE
board-id.reflectHost = FALSE
13. Search for ethernet0.virtualDev and set the value to vmxnet3
ethernet0.virtualDev = vmxnet3
14. Then paste the following options at the bottom of the file
board-id = Mac-AA95B1DDAB278B95
hw.model.reflectHost = FALSE
hw.model = MacBookPro19,1
serialNumber.reflectHost = FALSE
serialNumber = C01234567890
15. Right click on the MacOS14 VM ≫ Power On
Installing MacOS Sonoma
01. After an initialization sequence the MAC OS Setup should start
02. Select a Language ≫ Click the next arrow
03. Select Disk Utility
04. Select the VMware Virtual SATA Hard Drive Media ≫ Click Erase
05. Name the drive MacOS ≫ Set the Format to APFS ≫ Click Erase
06. Click Done ≫ Close Disk Utility
07. Click Install macOS
08. Click Continue ≫ Click Agree ≫ Click Agree again
09. Select the MacOS disk ≫ Click Install
10. Wait while Mac OS installs files, the VM will reboot several times
11. Select your Country or Region ≫ Click Continue
12. Confirm your languages and keyboard layout ≫ Click Continue
13. Click Not Now on the Accessibility screen
14. Click Continue on the Data & Privacy screen
15. Select Not Now on the Migration Assistant screen
16. Select Set Up Later and then Skip on the Apple ID screen
17. Click Agree ≫ Agree again
18. Enter a name, user name, password ≫ Click Continue
19. Click Continue ≫ Select Use or Dont Use for Location Services
20. Pick a timezone ≫ Click Continue
21. Uncheck Share Mac Analytics with Apple ≫ Click Continue
22. Click Set Up Later on the Screen Time screen
23. Pick a theme ≫ Click Continue
24. Welcome to MacOS 14 Sonoma
Install VMware Tools (optional, but recommended)
01. Right click the Install MacOS disc on the desktop ≫ Eject
02. On the VMware toolbar click Player ≫ Removable Devices ≫ CD/DVD ≫ Settings
03. Click Browse next to ISO Image File ≫ Browse to the extracted Unlocker files tools ≫ Select darwin.iso
04. Click the Connected checkbox
05. Click OK
06. Inside the VM, double click the mounted VMware tools and run the installer
07. When prompted, go into the Security settings and scroll to the bottom ≫ Click Allow next to VMware ≫ Reboot
08. After rebooting double click the mounted VMware tools and run the installer again
09. After the install succeeds, reboot again
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Running a MacOS 14 Sonoma VM in VMware](https://i.ytimg.com/vi/JRYECTBP-Yg/mqdefault.jpg)

![Run BookStack - Documentation/Wiki Platform - in Docker
#BookStack #Wiki #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0921.html
What is BookStack?
BookStack is an opinionated wiki system that provides a pleasant and simple out-of-the-box experience. New users to an instance should find the experience intuitive and only basic word-processing skills should be required to get involved in creating content on BookStack. The platform should provide advanced power features to those that desire it but they should not interfere with the core simple user experience. - https://github.com/BookStackApp/BookStack
Installing Docker
01. Log into the Linux based device
02. Run the following commands in the terminal
# install prerequisites
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release)/gpg | sudo apt-key add -
# add docker software repository
sudo add-apt-repository deb [arch=$(dpkg print-architecture)] https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release) $(lsb_release -cs) stable
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# enable and start docker service
sudo systemctl enable docker && sudo systemctl start docker
# add the current user to the docker group
sudo usermod -aG docker $USER
# reauthenticate for the new group membership to take effect
su - $USER
Running BookStack
01. Continue with the following commands in a terminal window
# list current uid and gid, note these for later
id $user
# create working directories
mkdir ~/docker/bookstack/config -p && mkdir ~/docker/mariadb -p
# set ownership on the working directories
sudo chown $USER:$USER ~/docker -R
# run the mariadb docker container
docker run -d name mariadb -e MYSQL_ROOT_PASSWORD=r00tp@$$ -e MYSQL_USER=bookstack_rw -e MYSQL_PASSWORD=B00k$t@ck! -e MYSQL_DATABASE=bookstack -v ~/docker/mariadb:/var/lib/mysql -p 3306:3306 restart=unless-stopped mariadb:latest
# run the bookstack docker image
# replace PUID, GUID with the output of the id $user command above
# replace DB_HOST and APP_URL with the docker host DNS name or IP address
docker run -d name bookstack -e PUID=1000 -e PGID=1000 -e TZ=America/New_York -e APP_URL=http://ubuntuserver.local:6875 -e DB_HOST=172.17.0.1 -e DB_PORT=3306 -e DB_USER=bookstack_rw -e DB_PASS=B00k$t@ck! -e DB_DATABASE=bookstack -p 6875:80 -v ~/docker/bookstack/config:/config restart unless-stopped lscr.io/linuxserver/bookstack:latest
02. Open a web browser and navigate to http://DNSorIP:6875
03. Login with the username admin@admin.com and the password password
04. Click the user dropdown at the top right ≫ My Account
05. Update the user name and email address as needed ≫ Click Save
06. Select Access & Security from the left navigation menu
07. Enter and confirm a new password ≫ Click Update
08. Click the user dropdown at the top right ≫ Logout
09. Log back in using the updated email address and password
10. Welcome to BookStack
Documentation: https://hub.docker.com/r/linuxserver/bookstack
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run BookStack - Documentation/Wiki Platform - in Docker](https://i.ytimg.com/vi/L2W3gJHQgdY/mqdefault.jpg)

![Run Actual Budget - Open Source Finance Management - in Docker
#ActualBudget #FOSS #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0969.html
What is Actual Budget?
Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting. - https://github.com/actualbudget/actual
Installing Docker
01. Log into the Linux based device
02. Run the following commands in the terminal
# install prerequisites
sudo apt install apt-transport-https ca-certificates git curl software-properties-common gnupg-agent -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release)/gpg | sudo apt-key add -
# add docker software repository
sudo add-apt-repository deb [arch=$(dpkg print-architecture)] https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release) $(lsb_release -cs) stable
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# enable and start docker service
sudo systemctl enable docker && sudo systemctl start docker
# add the current user to the docker group
sudo usermod -aG docker $USER
# reauthenticate for the new group membership to take effect
su - $USER
Running Actual
01. Now that Docker is installed, run the following commands to setup the Actual Docker container and run it
# create working directories
mkdir ~/docker/actualbudget/data -p
# create config.json
touch ~/docker/actualbudget/config.json
# write empty config file
echo {} ≫ ~/docker/actualbudget/config.json
# set owner of working directories
sudo chown $USER:$USER ~/docker -R
# allow the container to write to working directories
sudo chmod a+rwx -R ~/docker/actualbudget
# run actual budget container
docker run -d name actualbudget -p 5006:5006 -v ~/docker/actualbudget/config.json:/app/config.json -v ~/docker/actualbudget/data:/data restart=unless-stopped actualbudget/actual-server
02. Open a web browser and navigate to http://DNSorIP:5006
03. Click on the Advanced Options link
04. Check the I understand the risks box ≫ Click Open Actual
05. Enter and confirm an admin password
06. Click Start Fresh
07. Welcome to Actual running in Docker
Source: https://actualbudget.org/docs/install/docker/
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run Actual Budget - Open Source Finance Management - in Docker](https://i.ytimg.com/vi/LOsnghXY3uU/mqdefault.jpg)



![Run FreshRSS - RSS Feed Aggregator - in Docker
#FreshRSS #RSS #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0237.html
What is FreshRSS?
FreshRSS is a self-hosted RSS feed aggregator. It is lightweight, easy to work with, powerful, and customizable. - https://github.com/FreshRSS/FreshRSS
Installing Docker
01. Log into the Linux based device
02. Run the following commands in the terminal
# install prerequisites
sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release)/gpg | sudo apt-key add -
# add docker software repository
sudo add-apt-repository deb [arch=$(dpkg print-architecture)] https://download.docker.com/linux/$(awk -F= /^ID=/{ print $NF } /etc/os-release) $(lsb_release -cs) stable
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# enable and start docker service
sudo systemctl enable docker && sudo systemctl start docker
# add the current user to the docker group
sudo usermod -aG docker $USER
# reauthenticate for the new group membership to take effect
su - $USER
Running FreshRSS
01. Now that Docker is installed, run the following commands to setup the FreshRSS Docker container and run it
# create working directories
mkdir ~/docker/mariadb -p && mkdir ~/docker/freshrss/{data,extensions} -p
# set owner of working directories
sudo chown $USER:$USER ~/docker -R
# create containers network
docker network create containers
# run the mariadb docker container
docker run -d name mariadb network containers network-alias db -e MYSQL_ROOT_PASSWORD=r00tp@ss -e MYSQL_USER=freshrss_rw -e MYSQL_PASSWORD=Fr3shRSS! -e MYSQL_DATABASE=freshrss -v /home/$USER/docker/mariadb:/var/lib/mysql restart=unless-stopped mariadb:latest
# run the freshrss docker container
docker run -d name freshrss network containers -p 8089:80 -e CRON_MIN=1,31 -e TZ=America/New_York -v ~/docker/freshrss/data:/var/www/FreshRSS/data -v ~/docker/freshrss/extensions:/var/www/FreshRSS/extensions restart=unless-stopped freshrss/freshrss
02. Open a web browser and navigate to http://DNSorIP:8089
03. Select a Language ≫ Click Submit
04. Click the Go to the next step button
05. Complete the database configuration form as follows
Type of database: MySQL
Host: mariadb
Database username: freshrss_rw
Database password: Fr3shRSS!
Database: freshrss
Table prefix:
06. Click the Go to the next step button
07. Enter a username and password ≫ Click Submit
08. Click the Complete Installation button
09. Login with the username and password created earlier
10. Welcome to FreshRSS
Documentation: https://hub.docker.com/r/freshrss/freshrss
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run FreshRSS - RSS Feed Aggregator - in Docker](https://i.ytimg.com/vi/MOF0SfFp3zs/mqdefault.jpg)

![Install LibreNMS on Debian/Ubuntu
#LibreNMS #NetworkMonitoring #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0415.html
01. Log into the Debian device
02. Run the following commands in a terminal:
# update software repositories
sudo apt update
# install software updates
sudo apt upgrade -y
# install pre-requisites
sudo apt install acl curl composer fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nmap rrdtool snmp snmpd whois unzip python3-pymysql python3-dotenv python3-redis python3-setuptools python3-systemd python3-pip -y
# install Apache and MySQL
sudo apt install apache2 libapache2-mod-fcgid mariadb-server mariadb-client -y
# install PHP components
sudo apt install php7.3-cli php7.3-curl php7.3-fpm php7.3-gd php7.3-json php7.3-mbstring php7.3-mysql php7.3-snmp php7.3-xml php7.3-zip -y
# create librenms user
sudo useradd librenms -d /opt/librenms -M -r -s $(which bash)
# clone librenms github repo
sudo git clone https://github.com/librenms/librenms.git /opt/librenms
# set permissions
sudo chown -R librenms:librenms /opt/librenms
sudo chmod 771 /opt/librenms
sudo setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
sudo setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
# install composer dependencies
sudo su - librenms
./scripts/composer_wrapper.php install no-dev
exit
# set time zone for PHP fpm
sudo nano /etc/php/7.3/fpm/php.ini
03. Press CTRL+W to search ≫ type timezone ≫ Press Enter
04. Remove the ; to uncomment the line
05. Type in a valid timezone (https://php.net/manual/en/timezones.php)
06. Press CTRL+O, Enter, CTRL+X to write the changes to php.ini
07. Continue with the following commands in a terminal:
# set time zone for PHP cli
sudo nano /etc/php/7.3/cli/php.ini
08. Press CTRL+W to search ≫ type timezone ≫ Press Enter
09. Remove the ; to uncomment the line
10. Type in a valid timezone (https://php.net/manual/en/timezones.php)
11. Press CTRL+O, Enter, CTRL+X to write the changes to php.ini
12. Continue with the following commands in a terminal:
13. # set system time zone
sudo timedatectl set-timezone America/New_York
# edit mariaDB configuration
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
14. Paste the following under the [mysqld] section
innodb_file_per_table=1
lower_case_table_names=0
15. Press CTRL+O, Enter, CTRL+X to write the changes to 50-server.cnf
16. Continue with the following commands in a terminal:
# restart mariadb service
sudo systemctl restart mariadb
# configure the MySQL database
sudo su
mysql_secure_installation
17. Press Enter to login as root
18. Type Y and press Enter to set a root password, type the password twice to confirm
19. Type Y and press Enter to remove anonymous users
20. Type Y and press Enter to disallow root login remotely
21. Type Y and press Enter to remove the test database
22. Type Y and press Enter to reload privilege tables
23. Run the following command to login into MySQL:
mysql -u root -p
24. Authenticate with the root password set earlier
25. Run the following commands to create the LibreNMS database and database user
CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER librenms_rw@localhost IDENTIFIED BY Libr3NM$!;
GRANT ALL PRIVILEGES ON librenms.* TO librenms_rw@localhost;
FLUSH PRIVILEGES;
EXIT;
exit
26. Continue with the following commands:
# make a copy of www.conf
sudo cp /etc/php/7.3/fpm/pool.d/www.conf /etc/php/7.3/fpm/pool.d/librenms.conf
# edit librenms.conf
sudo nano /etc/php/7.3/fpm/pool.d/librenms.conf
27. Replace [www] with [librenms]
28. Change the user and group to librenms
user = librenms
group = librenms
29. Change the listen to php-fpm-librenms.sock
listen = /run/php-fpm-librenms.sock
30. Press CTRL+O, Enter, CTRL+X to write the changes to librenms.conf
31. Continue with the following commands:
# create librenms apache conf
sudo nano /etc/apache2/sites-available/librenms.conf
32. Paste the following configuration into librenms.vhost
≪VirtualHost *:80≫
DocumentRoot /opt/librenms/html/
#ServerName librenms.example.com
....Full steps can be found on GitHub [link at the top]
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install LibreNMS on Debian/Ubuntu](https://i.ytimg.com/vi/NYN1S73ST5M/mqdefault.jpg)