Uploaded August 2023 | Updated November 2026, 3 hours ago
#FreshRSS #RSS #Docker
Full steps can be found at 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. - 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 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)] 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: hub.docker.com/r/freshrss/freshrss
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro
#FreshRSS #RSS #Docker
Full steps can be found at 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. - 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 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)] 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: hub.docker.com/r/freshrss/freshrss
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro

![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)
![Update Microsoft Surface RT Tablet to Windows 10 [Unofficial Upgrade]
#SurfaceRT #Windows10
*** Updated 01/20/2024
Full steps can be found at https://i12bretro.github.io/tutorials/0824.html
Disclaimer
Windows 10 Build 15035 is now [over] five years old and it should not be considered as suitable for daily use. In addition to being outdated, it has numerous bugs and other issues expected of an expired pre-release build. - https://jwa4.gitbook.io/windows/tools/windows-media-builder
This process will overwrite the current Windows 8 RT operating system on the Surface RT tablet. I have tested these steps on my own device (as shown in this video), but I am not responsible if you damage or brick your device. Verify this process will work on your device before starting and make sure to backup any data you do not want to lose before proceeding.
Things You Will Need
- A USB flash drive, at least 8 GB https://amzn.to/3wkR5ju | https://amzn.to/3qkrJ1p | https://amzn.to/3Nhu9b9
- A x86/x64 PC with ~50 GB of free disk space to create the installation media
Creating the Installation Media
💡 NOTE: These steps must be completed on a separate x86/x64 based PC and cannot be done from the Surface RT tablet
01. Insert the USB flash drive into the PC and note the drive letter assigned to it
02. Download the Windows 10 Media Builder https://archive.org/download/windows-rt-device-tools/
03. Extract the downloaded Windows 10 Media Builder .zip file to the root of the c: drive
04. Navigate into the extracted folder ≫ Right click Build.cmd ≫ Run as administrator
05. In the Windows Media Builder application, type the number that corresponds to the target hardware in the list ≫ Press Enter
06. Read the notes displayed ≫ type Y and press Enter to continue
07. Choose to install the app pack by entering Y or N ≫ Press Enter
a. If the app pack is not being installed, Choose to uninstall provisioned apps by entering Y or N ≫ Press Enter
09. Choose to uninstall BitLocker by entering Y or N ≫ Press Enter
10. Choose to uninstall Cortana by entering Y or N ≫ Press Enter
11. Choose to uninstall Windows Defender by entering Y or N ≫ Press Enter
12. Choose to set a product key and use KMS activation by entering Y or N ≫ Press Enter
13. Choose to install Microsoft Office 2013 RT Home & Student Plus by entering Y or N ≫ Press Enter
a. Choose if you need a language other than English for Microsoft Office 2013 RT by entering Y or N ≫ Press Enter
b. Choose an update level to include with Microsoft Office 2013 RT by enter 1, 2 or 3 ≫ Press Enter
16. Type 1 and press enter to use the default Windows setup mode
17. Type 1 to use the Windows Imaging Format (WIM) compression ≫ Press Enter
18. Review the displayed summary of selected options ≫ Type Y ≫ Press Enter to continue
19. Wait while the Windows 10 files are downloaded and prepared based on the selections made above
20. When prompted, type Y to create USB installation media ≫ Press Enter
21. Enter the target USB drive letter to write the installation files to and Press Enter
⚠ Double check the drive letter entered, as the drive will be formatted and all data on the drive will be lost
22. Type Y and press Enter to confirm formatting the selected flash drive
23. Type N and press Enter when prompted to create an ISO image
24. Press any key to close out of the Windows Media Builder application
Installing Windows 10
🚨 WARNING: Continuing beyond this point will format the storage on the Surface RT tablet and all files and the Windows 8 RT operating system will be lost
01. Insert the prepared USB flash drive in the Surface RT tablet
02. Hold Vol- and press the power button, releasing the Vol- when Surface logo appears
03. Wait for Windows Setup to begin
04. Click Next
05. Check the I accept box ≫ Click Next
06. Click Custom: Install Windows only (advanced)
07. Delete the existing partitions by selecting each one and clicking Delete
08. Once all partitions have been deleted, click the Unallocated Space to select it ≫ Click Next
09. Wait while Windows 10 RT copies and installs files
10. Once the installation completes the tablet will reboot automatically
11. Complete the Windows 10 Out of Box Experience (OOBE)
Fixing Some Known Issues
01. Open Notepad and paste the following into the new document
Windows Registry Editor Version 5.00
; DISABLE USER ACCESS CONTROL (UAC)
[HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionPoliciesSystem]
EnableLUA=dword:00000000
; FIX CAMERA DRIVERS
[HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindows Media FoundationPlatform]
EnableFrameServerMode=dword:00000000
....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 Update Microsoft Surface RT Tablet to Windows 10 [Unofficial Upgrade]](https://i.ytimg.com/vi/Oz9D0bbVGBM/mqdefault.jpg)
![Install OctoPrint - 3D Printer Web UI - on Linux
#OctoPrint #3DPrinting #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0988.html
What is OctoPrint?
OctoPrint provides a snappy web interface for controlling consumer 3D printers. - https://github.com/OctoPrint/OctoPrint
Installation
01. Log into the Linux device
02. Run the following commands in terminal
# update software repositories
sudo apt update
# install available software updates
sudo apt upgrade -y
# install prerequisites
sudo apt install python3 python3-pip python3-dev python3-setuptools python3-venv git libyaml-dev build-essential libffi-dev libssl-dev -y
# create an octoprint directory
sudo mkdir /opt/OctoPrint
# set ownership of the directory
sudo chown $USER:$USER /opt/OctoPrint
# change directory
cd /opt/OctoPrint
# create a python virtual environment
python3 -m venv venv
# activate the virtual environment
source venv/bin/activate
# install wheel
pip install upgrade pip wheel
# install octoprint
pip install octoprint
# test octoprint installation
/opt/OctoPrint/venv/bin/octoprint serve
03. Open a web browser and navigate to http://DNSorIP:5000
04. Click Next on the Start screen
05. Click Next on the Restore Backup screen
06. Create an account my entering a Username and entering and confirming a password ≫ Click Create Account
07. Once the account is created, click Next
08. Choose to Enable or Disable the Connectivity Check ≫ Click Next
09. Choose to Enable or Disable Anonymous Usage Tracking ≫ Click Next
10. Choose to Enable or Disable the Plugin Blacklist ≫ Click Next
11. Click Next on the Webcam Wizard screen
12. Click Next on the Default Printer Profile screen
13. Click Next on the Server Commands screen
14. Acknowledge all the messages on the Finish screen ≫ Click Finish
15. Welcome to OctoPrint
Run OctoPrint as a Service (optional, but recommended)
01. Back in the Terminal, press CTRL+C to kill the running OctoPrint process
02. Continue with the following commands in terminal
# create octoprint service file
sudo nano /etc/systemd/system/octoprint.service
03. Paste the following into octoprint.service
[Unit]
Description=The snappy web interface for your 3D printer
After=network-online.target
Wants=network-online.target
[Service]
Environment=LC_ALL=C.UTF-8
Environment=LANG=C.UTF-8
Type=exec
User=≪% replace with your username %≫
ExecStart=/opt/OctoPrint/venv/bin/octoprint serve
[Install]
WantedBy=multi-user.target
04. Press CTRL+O, Enter, CTRL+X to write the changes
05. Continue with the following commands
# reload systemd services
sudo systemctl daemon-reload
# start the octoprint service on boot and now
sudo systemctl enable octoprint now
06. Back in the web browser, refresh the OctoPrint tab
Source: https://community.octoprint.org/t/setting-up-octoprint-on-a-raspberry-pi-running-raspberry-pi-os-debian/2337
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install OctoPrint - 3D Printer Web UI - on Linux](https://i.ytimg.com/vi/P-riUuuZee0/mqdefault.jpg)
![Run Homarr Application Dashboard in Docker
#Homarr #Dashboard #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0890.html
What is Homarr?
Simplify the management of your server with Homarr - a sleek, modern dashboard that puts all of your apps and services at your fingertips. With Homarr, you can access and control everything in one convenient location. Homarr seamlessly integrates with the apps youve added, providing you with valuable information and giving you complete control. Installation is a breeze, and Homarr supports a wide range of deployment methods. - https://github.com/ajnart/homarr
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 Homarr
01. Now that Docker is installed, run the following commands to setup the Homarr Docker container and run it
# create working directory structure
mkdir ~/docker/homarr/{configs,data,icons} -p
# run homarr container
docker run -d name=homarr -p 7575:7575 -v /var/run/docker.sock:/var/run/docker.sock -v ~/docker/homarr/configs:/app/data/configs -v ~/docker/homarr/data:/data -v ~/docker/homarr/icons:/app/public/icons restart=unless-stopped ghcr.io/ajnart/homarr:latest
02. Open a web browser and navigate to http://DNSorIP:7575
03. Click the Start update process button
04. Click Continue
05. Enter an admin username and enter and confirm a password ≫ Click Continue
06. Click the Go to your board button
07. Welcome to Homarr running in Docker
Source: https://homarr.dev/docs/getting-started/installation/
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run Homarr Application Dashboard in Docker](https://i.ytimg.com/vi/PCsUL_sgWfw/mqdefault.jpg)
![Run OctoPrint - 3D Printer Web UI - in Docker
#OctoPrint #3DPrinting #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0990.html
What is OctoPrint?
OctoPrint provides a snappy web interface for controlling consumer 3D printers. - https://github.com/OctoPrint/OctoPrint
Installing Docker
01. Log into the Linux host and run the following commands in a terminal window
# 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 OctoPrint Container
01. Continue with the following commands in a terminal window
# create working directories
mkdir ~/docker/octoprint -p
# set owner of docker directory
sudo chown $USER:$USER ~/docker -R
# allow the container to write to working directories
sudo chmod a+rwx -R ~/docker/octoprint
# run the octoprint container
docker run -d name octoprint -v ~/docker/octoprint:/octoprint device /dev/ttyACM0:/dev/ttyACM0 -p 8041:80 restart=unless-stopped octoprint/octoprint
02. Open a web browser and navigate to http://DNSorIP:8041
03. Click Next on the Start screen
04. Click Next on the Restore Backup screen
05. Create an account my entering a Username and entering and confirming a password ≫ Click Create Account
06. Once the account is created, click Next
07. Choose to Enable or Disable the Connectivity Check ≫ Click Next
08. Choose to Enable or Disable Anonymous Usage Tracking ≫ Click Next
09. Choose to Enable or Disable the Plugin Blacklist ≫ Click Next
10. Click Next on the Webcam Wizard screen
11. Click Next on the Default Printer Profile screen
12. Click Next on the Server Commands screen
13. Acknowledge all the messages on the Finish screen ≫ Click Finish
14. Welcome to OctoPrint
Documentation: https://github.com/OctoPrint/octoprint-docker
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run OctoPrint - 3D Printer Web UI - in Docker](https://i.ytimg.com/vi/Q0b6gNJlZ2g/mqdefault.jpg)


![Install BookStack - Documentation/Wiki Platform - on Windows
#BookStack #Wiki #Windows
Full steps can be found at https://i12bretro.github.io/tutorials/0920.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
Installation
01. Download XAMPP https://sourceforge.net/projects/xampp/files/XAMPP%20Windows/
02. Download BookStack https://github.com/BookStackApp/BookStack/releases/latest
03. Download Microsoft Visual C++ https://aka.ms/vs/16/release/vc_redist.x64.exe
04. Download Composer https://getcomposer.org/Composer-Setup.exe
05. Install Microsoft Visual C++
06. Right click the downloaded XAMPP .zip file ≫ Extract All...
07. Right click the downloaded BookStack .zip file ≫ Extract All...
08. Rename the extracted folder bookstack
09. Cut the bookstack folder inside the XAMPP directory
10. Copy the extracted XAMPP directory to a safe location to run from, C:Program Files for example
11. Run XAMPP/setup_xampp.bat to update the configuration files with the new server location
Configuring the Web Server
01. Navigate to XAMPP/php and edit php.ini
02. Find the following line and remove the ; to uncomment them
extension=ldap
extension=gd
03. Save the changes to php.ini
04. Navigate to XAMPP/apache/conf and edit httpd.conf
05. Paste the following configuration at the bottom of the file, update the folder paths as needed
Alias /bookstack C:/Program Files/xampp/bookstack/public/
≪Directory C:/Program Files/xampp/bookstack/public/≫
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
≪IfModule mod_rewrite.c≫
≪IfModule mod_negotiation.c≫
Options -MultiViews -Indexes
≪/IfModule≫
RewriteEngine On
# Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
# Redirect Trailing Slashes If Not A Folder...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} (.+)/$
RewriteRule ^ %1 [L,R=301]
# Handle Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
≪/IfModule≫
≪/Directory≫
06. Save the changes to httpd.conf
07. Install Composer
08. Run XAMPP/xampp-control.exe
09. Click the Start button next to Apache and MySQL
10. Navigate to XAMPP/mysql/bin
11. Hold the SHIFT key and right click in the white space ≫ Open PowerShell window here...
12. Type the following in the PowerShell window to setup the BookStack database
.mysql -u root
CREATE DATABASE bookstack;
GRANT ALL ON bookstack.* to bookstack_rw@localhost IDENTIFIED BY B00k$t@ck!;
FLUSH PRIVILEGES;
EXIT;
exit
13. Navigate to the XAMPP/bookstack folder ≫ Right click in the white space ≫ Open PowerShell window here...
14. Run the following command to download dependencies
# create a copy of the sample .env file
cp ..env.example ..env
# edit .env in notepad
notepad ..env
15. Modifying the following key/value pairs in .env as needed
APP_ENV=production
APP_DEBUG=false
APP_KEY=SomethingSecure
APP_URL=http://windows11.local/bookstack
APP_TIMEZONE=America/New_York
APP_LOCALE=en
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=bookstack
DB_USERNAME=bookstack_rw
DB_PASSWORD=B00k$t@ck!
MAIL_DRIVER=smtp
MAIL_HOST=smtp.i12bretro.local
MAIL_PORT=25
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDR=bookstack@i12bretro.local
MAIL_FROM_NAME=BookStack
MAIL_REPLYTO_ADDR=bookstack@i12bretro.local
MAIL_REPLYTO_NAME=BookStack
MAIL_AUTO_EMBED_METHOD=attachment
16. Save the changes to .env
17. Continue with the following commands in PowerShell
# install dependencies with composer
composer install no-dev no-plugins
# generate app key
php artisan key:generate no-interaction force
# migrate the database
php artisan migrate no-interaction force
....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 BookStack - Documentation/Wiki Platform - on Windows](https://i.ytimg.com/vi/QZnSIiRalMU/mqdefault.jpg)
![Flashing H310/H710 RAID Controllers to LSI IT Mode
#RAID #ITMode #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0837.html
Background
I recently purchased a Dell Poweredge server with a H310 RAID controller. One of the purposes of the new server is to run TrueNAS Scale as a VM inside Proxmox. To get the best performance out of TrueNAS and ZFS, the H310 needs to be flashed to LSI IT mode so ZFS can have direct access to the drives. IT mode also improves the disk drive IOPS (Input/output operations per second) performance.
What is LSI IT Mode?
IT (Initiator Target) mode essentially disables the hardware RAID capabilities of the controller, allowing the operating system to see and interact with each disk drive directly.
Disclaimer
This process will overwrite the firmware on the RAID controller. If not done correctly, the process can damage and brick the RAID controller.
Things You Will Need
- A USB flash drive, at least 4 GB https://amzn.to/3wkR5ju | https://amzn.to/3qkrJ1p | https://amzn.to/3Nhu9b9
- One of the following hardware RAID controllers
H310 Mini Mono (⇦ used in this tutorial)
H310 Full Size
H710 Mini Mono
H710P Mini Mono
H710 Full Size
H710P Full Size
H810 Full Size
Before You Begin
01. Remove the battery from the RAID controller
02. Disable the following technologies in the BIOS
- Virtualization
- SR-IOV
- IOMMU
06. Set the Boot Mode to BIOS/Legacy (not UEFI)
Preparing the Flash Utilities
Huge thanks to http://fohdeesha.com for compiling the software and steps to complete the flashing process into an easy to follow procedure.
01. Download the PERC flashing utilities https://fohdeesha.com/docs/store/perc/perc-crossflash-v2.2.zip
02. Download the Ventoy installer https://www.ventoy.net/en/download.html
03. Extract the downloaded perc-crossflash .zip file
04. Extract the downloaded Ventoy .zip file
05. Run Ventoy2Disk.exe
06. Plug in a USB flash drive at least 4 GB in size
07. Click the refresh icon
08. Select the flash drive from the device dropdown
09. Click the Install button
10. After the installation completes, copy the Linux and FreeDOS .iso files from the extracted perc-crossflash folder to the Ventoy partition
11. Safely remove the USB flash drive
12. Plug the flash drive into the target server
Collecting RAID Controller Information
01. Power on the server hardware ≫ Boot to the flash drive
02. Select the FreeDOS .iso from the Ventoy menu
03. Once FreeDOS has booted, run the following command
info
04. Take a photo of and/or carefully write down the SAS address from the output
05. Compare the output Product Name and ChipRevision (H310 Mini in this example) to the listing on https://fohdeesha.com/docs/perc.html#finding-your-card-revision; If there isnt an EXACT MATCH stop
06. Shutdown or reboot the server
Flashing to IT Mode
The steps below are specific to the H310 Mini RAID controller in my device (https://fohdeesha.com/docs/H310.html). Make sure to follow the steps for your target RAID controller model.
01. Power on the server hardware ≫ Boot to the flash drive
02. Select the Linux .iso from the Ventoy menu
03. Log into Linux using the username user and password live
04. If you plan to SSH into the device, run the following command to output the IP address and connect via SSH
ipinfo
05. Continue with the following commands in Linux on the target server device
# elevate to root shell
sudo su -
# output the SAS address
# take a photo of and/or carefully write down the SAS address from the output
# it will be required after the flashing process
sas-mega
# flash the raid controller firmware
H310-Mini
# once the flash completes without errors, reboot the server
reboot now
06. Boot to the flash drive
07. Select the Linux .iso from the Ventoy menu
NOTE: If you see kernel panic errors during startup, shutdown the server hardware and power it back on and boot back into Linux from Ventoy
08. Log back into Linux using the username user and password live
09. Continue with the following commands
# elevate to root shell
sudo su -
# set the sas address
setsas ≪%sas address from output earlier%≫
# output info about the new state of the controller
info
10. If youll be booting from drives attached to the RAID controller, continue with the following steps to flash the boot ROM images
# flash bios/legacy boot rom
flashboot /root/Bootloaders/mptsas2.rom
# flash uefi boot rom
flashboot /root/Bootloaders/x64sas2.rom
# shutdown the system
....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 Flashing H310/H710 RAID Controllers to LSI IT Mode](https://i.ytimg.com/vi/QfQKwBKt4vg/mqdefault.jpg)
![Install LimeSurvey CE - Custom Survey Tool - on Linux
#LimeSurvey #Surveys #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0498.html
What is LimeSurvey?
[LimeSurvey is] a powerful, open-source survey platform. A free alternative to SurveyMonkey, Typeform, Qualtrics, and Google Forms, making it simple to create online surveys and forms with unmatched flexibility. - https://github.com/LimeSurvey/LimeSurvey
Installation
01. Log into the Linux device
02. Run the following commands in a terminal:
# update software repositories
sudo apt update
# install any available software updates
sudo apt upgrade -y
# install Apache HTTPD and MySQL
sudo apt install apache2 mariadb-server mariadb-client wget zip -y
# install PHP components
sudo apt install php php-mysql php-common php-gd php-mbstring php-xml php-ldap php-intl php-zip php-imap -y
# configure the MySQL database
sudo mysql_secure_installation
03. Press Enter to login as root
04. Type N and press Enter to not switch to socket authentication
05. Type Y and press Enter to set a root password, type the password twice to confirm
06. Type Y and press Enter to remove anonymous users
07. Type Y and press Enter to disallow root login remotely
08. Type Y and press Enter to remove the test database
09. Type Y and press Enter to reload privilege tables
10. Run the following command to login into MySQL:
sudo mysql -u root -p
11. Authenticate with the root password set earlier
12. Run the following commands to create the limesurvey database and database user
CREATE DATABASE limesurvey DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
GRANT ALL ON limesurvey.* TO limesurvey_rw@localhost IDENTIFIED BY L!m3Surv3Y;
FLUSH PRIVILEGES;
EXIT;
13. Continue with the following commands to download and extract LimeSurvey to the webroot
# fetch the latest download URL
regex=(https://download.limesurvey.org/latest-master/limesurvey[^/]*.zip) && response=$(curl https://community.limesurvey.org/downloads/) && [[ $response =~ $regex ]] && downloadURL=${BASH_REMATCH[1]}
# download latest limesurvey version
sudo wget -O /tmp/limesurvey.zip $downloadURL
# extract the downloaded zip archive
sudo unzip /tmp/limesurvey.zip -d /var/www/html
# set ownership
sudo chown -R www-data:www-data /var/www/html/limesurvey
# set permissions
sudo chmod -R 755 /var/www/html/limesurvey/tmp && sudo chmod -R 755 /var/www/html/limesurvey/upload && sudo chmod -R 755 /var/www/html/limesurvey/application/config/
14. Open a web browser and navigate to http://DNSorIP/limesurvey
15. Select a Language ≫ Click Start installation at the Welcome screen
16. Click I accept at the License Agreement
17. Click Next at the Pre-Installation Check
18. Complete the Database Configuration as shown below
Database type: MySQL
MySQL database engine type: MyISAM
Database location: localhost
Database user: limesurvey_rw
Database Password: L!m3Surv3Y
Database name: limesurvey
Table Prefix:
19. Click Next ≫ Click Populate database
20. Complete the Administration settings form ≫ Click Next
21. Click Administration
22. Login using the admin credentials created earlier
23. Welcome to LimeSurvey
Source: https://manual.limesurvey.org/Installation LimeSurvey_CE
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install LimeSurvey CE - Custom Survey Tool - on Linux](https://i.ytimg.com/vi/R28RuvDBA6w/mqdefault.jpg)