Uploaded February 2025 | Updated November 2026, 3 hours ago
#MkDocs #Python #Linux
Full steps can be found at i12bretro.github.io/tutorials/0983.html
--------------------------------------------------------------------
What is MkDocs?
--------------------------------------------------------------------
MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third-party themes, plugins, and Markdown extensions. - github.com/mkdocs/mkdocs
--------------------------------------------------------------------
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
# install prerequisites
sudo apt install wget apt-transport-https -y
# install python
sudo apt install python3-full python3-pip -y
# install mkdocs
sudo apt install mkdocs -y
# create a mkdocs directory in user directory
mkdir ~/mkdocs
# change directory to mkdocs
cd ~/mkdocs
# create a mkdocs site
mkdocs new mkdocs-demo
# change directory to mkdocs-demo
cd mkdocs-demo
# start the demo site
mkdocs serve
03. Open a web browser and navigate to http://DNSorIP:8000
--------------------------------------------------------------------
Read the Docs Theme
--------------------------------------------------------------------
01. Back in the terminal, press CTRL+C to kill the running process
02. Run the following command
# edit the mkdocs configuration file
nano ./mkdocs.yml
03. Add the following line to mkdocs.yml
theme: readthedocs
04. Press CTRL+O, Enter, CTRL+X to write the changes
05. Run the following command to see the change
# restart the demo site
mkdocs serve
Source: mkdocs.org/getting-started
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro
#MkDocs #Python #Linux
Full steps can be found at i12bretro.github.io/tutorials/0983.html
--------------------------------------------------------------------
What is MkDocs?
--------------------------------------------------------------------
MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third-party themes, plugins, and Markdown extensions. - github.com/mkdocs/mkdocs
--------------------------------------------------------------------
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
# install prerequisites
sudo apt install wget apt-transport-https -y
# install python
sudo apt install python3-full python3-pip -y
# install mkdocs
sudo apt install mkdocs -y
# create a mkdocs directory in user directory
mkdir ~/mkdocs
# change directory to mkdocs
cd ~/mkdocs
# create a mkdocs site
mkdocs new mkdocs-demo
# change directory to mkdocs-demo
cd mkdocs-demo
# start the demo site
mkdocs serve
03. Open a web browser and navigate to http://DNSorIP:8000
--------------------------------------------------------------------
Read the Docs Theme
--------------------------------------------------------------------
01. Back in the terminal, press CTRL+C to kill the running process
02. Run the following command
# edit the mkdocs configuration file
nano ./mkdocs.yml
03. Add the following line to mkdocs.yml
theme: readthedocs
04. Press CTRL+O, Enter, CTRL+X to write the changes
05. Run the following command to see the change
# restart the demo site
mkdocs serve
Source: mkdocs.org/getting-started
### Connect with me and others ###
★ Discord: discord.com/invite/EzenvmSHW8
★ Reddit: reddit.com/r/i12bretro
★ Twitter: twitter.com/i12bretro

![Running Homepage Application Dashboard Using Docker
#Homepage #Dashboard #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0859.html
What is Homepage?
[Homepage is] a modern, fully static, fast, secure fully proxied, highly customizable application dashboard with integrations for over 100 services and translations into multiple languages. Easily configured via YAML files or through docker label discovery. - https://github.com/benphelps/homepage
Installing Docker
01. Log into the Linux Docker 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 Homepage Application Dashboard
01. Continue with the following commands in a terminal window
# list current uid and gid, note these for later
id $user
# make a homepage directory to mount in the container
mkdir ~/homepage -p
# run the homepage docker image
# replace PUID, GUID with the output of the id $user command above
docker run -d name=homepage -e PUID=1000 -e PGID=1000 -p 8006:3000 -v ~/homepage:/app/config -v /var/run/docker.sock:/var/run/docker.sock restart unless-stopped ghcr.io/benphelps/homepage
02. Open a web browser and navigate to http://DNSorIP:8006
Source: https://gethomepage.dev/en/installation/docker
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Running Homepage Application Dashboard Using Docker](https://i.ytimg.com/vi/BzjL3tZ-NQs/mqdefault.jpg)
![Install SolidInvoice - Open Source Invoicing Software - on Linux
#SolidInvoice #Invoicing #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0910.html
What is SolidInvoice?
SolidInvoice is a sophisticated open-source invoicing application designed to assist small businesses and freelancers in efficiently managing their daily billing operations. With its comprehensive range of features, this elegant online platform ensures that you receive timely payments. - https://github.com/SolidInvoice/SolidInvoice
Installation
01. Log into the Linux device
02. Run the following commands in a terminal window:
# update software repositories
sudo apt update
# install available software updates
sudo apt upgrade -y
# install prerequisites
sudo apt install curl wget zip -y
# install Apache HTTPD and MySQL
sudo apt install apache2 mariadb-server mariadb-client -y
# install PHP components
sudo apt install php php-curl php-common php-json php-mysqli php-mysql php-pdo-mysql php-opcache php-bcmath php-intl php-gd php-xsl php-soap php-zip php-apcu -y
# configure the MySQL database
sudo su
mysql_secure_installation
03. Press Enter to login as root
04. Type N and press Enter to not switch to unix 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:
mysql -u root -p
11. Authenticate with the root password set earlier
12. Run the following commands to create the SolidInvoice database and database user
CREATE DATABASE solidinvoice;
GRANT ALL ON solidinvoice.* to solidinvoice_rw@localhost IDENTIFIED BY SolidInv0ic3!;
FLUSH PRIVILEGES;
EXIT;
exit
13. Continue with the following commands:
# fetch the latest download URL
regex=browser_download_url: (https://github.com/SolidInvoice/SolidInvoice/releases/download/[^/]*/SolidInvoice-[^/]*.zip) && response=$(curl -H Accept: application/vnd.github.v3+json https://api.github.com/repos/SolidInvoice/SolidInvoice/releases/latest) && [[ $response =~ $regex ]] && downloadURL=${BASH_REMATCH[1]}
# download the latest release
wget -O /tmp/solidinvoice.zip $downloadURL
# create target directory
sudo mkdir /var/www/solidinvoice
# extract the downloaded zip to /var/www/solidinvoice
sudo unzip /tmp/solidinvoice.zip -d /var/www/solidinvoice
# set the owner of the solidinvoice directory
sudo chown -R www-data:www-data /var/www/solidinvoice
# create solidinvoice apache configuration
sudo nano /etc/apache2/sites-available/solidinvoice.conf
14. Paste the following configuration into solidinvoice.conf
≪VirtualHost *:8080≫
ServerName ≪%DNSORIP%≫
#ServerAlias www.yourdomain.com
DocumentRoot /var/www/solidinvoice/public
≪Directory /var/www/solidinvoice/public≫
# enable the .htaccess rewrites
AllowOverride All
Order allow,deny
Allow from All
≪/Directory≫
ErrorLog /var/log/apache2/solidinvoice.error.log
CustomLog /var/log/apache2/solidinvoice.access.log combined
≪/VirtualHost≫
15. Press CTRL+O, Enter, CTRL+X to write the changes
16. Run the following command to enable the solidinvoice site
# enable rewrite module
sudo a2enmod rewrite
# enable the solidinvoice site
sudo a2ensite solidinvoice
# restart the apache2 service
sudo systemctl restart apache2
SolidInvoice Web Installer
01. Open a web browser and navigate to http://DNSorIP:8080
02. Click the Next button at the lower right corner of the System Requirements page
03. Complete the Database settings as follows:
Driver: Mysql
Host: localhost
Port: 3306
User: solidinvoice_rw
Password: SolidInv0ic3!
Database Name: solidinvoice
04. Click Next
05. After the database schema is created successfully ≫ Click Next
06. Click the Log In Now button
07. Login with the admin credentials created earlier
08. Enter a Company Name and select the default currency ≫ Click Create
09. Welcome to SolidInvoice
Source: https://docs.solidinvoice.co/en/latest/guide/getting_started.html
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install SolidInvoice - Open Source Invoicing Software - on Linux](https://i.ytimg.com/vi/CeD_k7UhiO4/mqdefault.jpg)
![Run Apache Subversion Containerized in Docker
#Subversion #Docker #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0715.html
What is Subversion?
Subversion exists to be universally recognized and adopted as an open-source, centralized version control system characterized by its reliability as a safe haven for valuable data; the simplicity of its model and usage; and its ability to support the needs of a wide variety of users and projects, from individuals to large-scale enterprise operations. - https://subversion.apache.org/
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 Subversion
01. Now that Docker is installed, run the following commands to setup the Subversion Docker container and run it
# create repository directory
mkdir ~/docker/subversion/repos -p
# run subversion container
docker run -d name=subversion -p 8080:80 -p 3690:3690 -v ~/docker/subversion/repos:/data/svn -e SVN_LOCAL_ADMIN_USER=admin -e SVN_LOCAL_ADMIN_PASS=SomethingSecure restart=unless-stopped iaean/subversion
02. Open a web browser and navigate to http://DNSorIP:8080
03. Login with the credentials set with the SVN_LOCAL_ADMIN_USER and SVN_LOCAL_ADMIN_PASS environment variables
04. Open a new browser tab and navigate to http://DNSorIP:8080/websvn
05. Welcome to Subversion running in Docker
Create a New Repository
01. With Subversion running, continue with the following commands to create a new code repository
# create a repository called demorepo
docker exec -it subversion /usr/bin/svnadmin create /data/svn/sandbox/demorepo
02. Back in the browser refresh WebSVN to see the new repository
Source: https://github.com/iaean/docker-subversion
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run Apache Subversion Containerized in Docker](https://i.ytimg.com/vi/CfRWDbUsubA/mqdefault.jpg)
![Running MediaWiki in Docker on Ubuntu Server
#MediaWiki #Wikipedia #Docker
*** Updated 08/19/2024
Full steps can be found at https://i12bretro.github.io/tutorials/0594.html
What is MediaWiki?
The MediaWiki software is used by tens of thousands of websites and thousands of companies and organizations. It powers Wikipedia and also this website. MediaWiki helps you collect and organize knowledge and make it available to people. Its powerful, multilingual, free and open, extensible, customizable, reliable, and free of charge. - https://www.mediawiki.org/wiki/MediaWiki
Installing Docker
01. Log into the Linux host and run the following commands in a terminal window
# update software respositories
sudo apt update
# install available software updates
sudo apt upgrade -y
# install prerequisites
sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# add docker apt repository
sudo add-apt-repository deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# 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 MediaWiki Container
01. Continue with the following commands in a terminal window
# create working directories
mkdir /home/$USER/docker/mediawiki/images -p && mkdir /home/$USER/docker/mariadb -p
# set owner of working directories
sudo chown $USER:$USER /home/$USER/docker -R
# create containers network
docker network create containers
# run the mariadb docker container
docker run name mariadb -e MYSQL_ROOT_PASSWORD=r00tp@$$ -e MYSQL_USER=mediawiki_rw -e MYSQL_PASSWORD=WikiW1k1What! -e MYSQL_DATABASE=mediawiki -v /home/$USER/docker/mariadb:/var/lib/mysql network containers restart=unless-stopped -d mariadb:latest
# run the mediawiki docker container
docker run -d name mediawiki -p 8080:80 -e MYSQL_USER=mediawiki_rw -e MYSQL_PASSWORD=WikiW1k1What! -e MYSQL_DATABASE=mediawiki -v /home/$USER/docker/mediawiki/images:/var/www/html/images network containers mediawiki:latest
02. Open a web browser and navigate to http://DNSorIP:8080
03. Scroll to the bottom and click the set up the wiki link
04. Set the Languages ≫ Click Continue
05. Click Continue at the Welcome screen
06. Complete the Database settings as follows:
Database type:
Database host: mariadb
Database name: mediawiki
Database table prefix:
Database username: mediawiki_rw
Database password: WikiW1k1What!
07. Click Continue
08. Leave the Use the same account as for installation box checked ≫ Click Continue
09. Give the Wiki a name and create an administrator username and password
10. Uncheck the Share data about this installation with MediaWiki developers box
11. Check the Im bored already, just install the wiki box ≫ Click Continue
12. Click Continue again to begin the installation
13. After the installation completes click Continue
14. At the Download LocalSettings.php page, download the file
15. Open the downloaded LocalSettings.php and copy the contents to the clipboard
16. Back on the Docker host, run the following command to create LocalSettings.php in the correct location
# create and edit LocalSettings.php
nano /home/$USER/docker/mediawiki/LocalSettings.php
17. Paste the copied contents from the downloaded LocalSettings.php
18. Press CTRL+O, Enter, CTRL+X to write the changes
19. Continue with the following commands
# remove mediawiki container
docker rm mediawiki force
# re-initialize mediawiki container with local settings
docker run -d name mediawiki -p 8080:80 -e MYSQL_USER=mediawiki_rw -e MYSQL_PASSWORD=WikiW1k1What! -e MYSQL_DATABASE=mediawiki -v /home/$USER/docker/mediawiki/images:/var/www/html/images -v /home/$USER/docker/mediawiki/LocalSettings.php:/var/www/html/LocalSettings.php network containers restart=unless-stopped mediawiki:latest
# allow the container to write to working directories
sudo chmod a+rwx -R ~/docker
20. Back in the browser click the enter your wiki link
21. Click the Log In link at the top right
22. Log in with the administrator account created during the setup
23. Welcome to MediaWiki
Source: https://hub.docker.com/_/mediawiki
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Running MediaWiki in Docker on Ubuntu Server](https://i.ytimg.com/vi/D4cF9rEhXuk/mqdefault.jpg)

![Install Mattermost - Secure Collaboration Platform - on Linux
#Mattermost #Collaboration #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0888.html
What is Mattermost?
Mattermost is a secure collaboration platform for accelerating mission-critical collaborative work. The platform is built to meet the custom needs of technical and operational teams in rigorous and complex environments, including government, defense, and critical infrastructure. Mattermost gives organizations full control over their data with self-hosted and private deployment options and access to the source code. - https://docs.mattermost.com/about/product.html
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
# install prerequisites
sudo apt install wget git apt-transport-https -y
# install postgresql
sudo apt install postgresql postgresql-client -y
# enable the postgresql service and start it
sudo systemctl enable postgresql now
# connect to postgresql
sudo -u postgres psql postgres
# create mattermost database user
create user mattermost_rw with password Matt3rM0st;
# create mattermost database
create database mattermost with encoding=UTF8 template=template0 owner=mattermost_rw;
# close postgresql connection
exit
# create mattermost user
sudo useradd -mrd /opt/mattermost mattermost -s $(which bash)
# create /opt/mattermost directory
sudo mkdir /opt/mattermost -p
# set owner of /opt/mattermost
sudo chown mattermost:mattermost /opt/mattermost -R
# switch to mattermost user
sudo su - mattermost
# fetch the latest download URL
regex=(https://releases.mattermost.com/[^/]*/mattermost-[^/]*-linux-amd64.tar.gz) && response=$(curl https://docs.mattermost.com/about/version-archive.html) && [[ $response =~ $regex ]] && downloadURL=${BASH_REMATCH[1]}
# download mattermost
wget -O /tmp/mattermost.tar.gz $downloadURL
# extract the download
tar -xvzf /tmp/mattermost.tar.gz -C /opt/mattermost strip-component 1
# backup config json file
cp /opt/mattermost/config/config.json /opt/mattermost/config/config.json.orig
# edit config.json
nano /opt/mattermost/config/config.json
03. Set the SiteURL value
SiteURL: http://debian.local,
04. Scroll down to find the SqlSettings configuration, update the DataSource value as follows
DataSource: postgres://mattermost_rw:Matt3rM0st@localhost/mattermost?sslmode=disableu0026connect_timeout=10u0026binary_parameters=yes,
05. Press CTRL+O, Enter, CTRL+X to write the changes
Running Mattermost as a Service
01. Back in the Terminal, continue with the following commands
# exit the mattermost user shell
exit
# create mattermost service file
sudo nano /etc/systemd/system/mattermost.service
02. Paste the following into mattermost.service
[Unit]
Description=Mattermost
After=postgresql.service
BindsTo=postgresql.service
[Service]
Type=notify
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
KillMode=mixed
Restart=always
RestartSec=10
WorkingDirectory=/opt/mattermost
User=mattermost
Group=mattermost
LimitNOFILE=49152
[Install]
WantedBy=multi-user.target
03. Press CTRL+O, Enter, CTRL+X to write the changes
04. Continue with the following commands
# reload systemd services
sudo systemctl daemon-reload
# start mattermost service on boot and now
sudo systemctl enable mattermost now
05. Open a web browser and navigate to http://DNSorIP:8065
06. Click the View in Browser button
07. Complete the form to create an account
08. Enter an Organization Name ≫ Click Continue
09. Complete the remaining prompts or choose to skip
10. Welcome to Mattermost
Source: https://docs.mattermost.com/install/install-tar.html
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install Mattermost - Secure Collaboration Platform - on Linux](https://i.ytimg.com/vi/Dqa6yBUWhgo/mqdefault.jpg)
![Install Actual Budget - Open Source Finance Management - on Linux
#ActualBudget #FOSS #Linux
Full steps can be found at https://i12bretro.github.io/tutorials/0967.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 NodeJS
01. Log into the Linux device
02. Run the following commands in a terminal window
# add nodejs software repository
curl -sL https://deb.nodesource.com/setup_20.x | sudo bash -
# install nodejs
sudo apt install nodejs -y
# test node & npm are working
node -v && npm -v
Installing Actual
01. Continue with the following commands:
# install git
sudo apt install git -y
# create working directory
sudo mkdir /usr/local/actualbudget -p
# set folder ownership
sudo chown -R $USER:$USER /usr/local/actualbudget
# clone actual github repo
git clone https://github.com/actualbudget/actual-server.git /usr/local/actualbudget
# cd into git clone
cd /usr/local/actualbudget
# checkout the latest tagged release
git checkout $(git tag sort=v:refname | tail -n1)
# install yarn
sudo npm install -g yarn
# install dependencies
yarn install
# create a service file
sudo nano /etc/systemd/system/actualbudget.service
02. Paste the following configuration
[Unit]
Description=Actual Server
[Service]
Type=simple
ExecStart=/usr/bin/yarn start
WorkingDirectory=/usr/local/actualbudget
Environment=NODE_ENV=production
Restart=always
# Restart service after 10 seconds if node service crashes
RestartSec=10
[Install]
WantedBy=multi-user.target
03. Press CTRL+O, Enter, CTRL+X to write the changes
04. Continue with the following commands
# reload services
sudo systemctl daemon-reload
# start and enable actual budget service
sudo systemctl enable actualbudget.service now
05. Open a web browser and navigate to http://DNSorIP:5006
06. Enter and confirm an admin password
07. Click the link to create an account
08. Click Start Fresh
09. Welcome to Actual Budget
Source: https://actualbudget.org/docs/install/local/
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Install Actual Budget - Open Source Finance Management - on Linux](https://i.ytimg.com/vi/EIm0vvuM0kw/mqdefault.jpg)
![Running Snipe-IT in Docker
#SnipeIT #AssetManagement #Docker
*** Updated 08/05/2024
Full steps can be found at https://i12bretro.github.io/tutorials/0567.html
What is Snipe-IT?
Snipe-IT is a Free Open Source (FOSS) project built on Laravel. Snipe-IT was made for IT asset management, to enable IT departments to track who has which laptop, when it was purchased, which software licenses and accessories are available, and so on. - https://snipe-it.readme.io/docs
Installing Docker
01. Log into the Linux host
02. 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 Snipe-IT
01. Continue with the following commands in terminal to setup and run Snipe-IT
# create working directories
sudo mkdir ~/docker/snipeit/{config,data} -p && sudo mkdir ~/docker/mariadb -p
# create snipeit network
docker network create snipeit
# download the base configuration
sudo wget -O ~/docker/snipeit/.env https://raw.githubusercontent.com/snipe/snipe-it/master/.env.example
# generate an app_key
docker run rm snipe/snipe-it
# edit the .env file
sudo nano ~/docker/snipeit/.env
02. Scroll through the .env file, making sure to comment out the mysql connection details and change the following fields as needed
#
# REQUIRED: BASIC APP SETTINGS
#
APP_ENV=production
APP_DEBUG=false
APP_KEY=≪%PASTED APP_KEY%≫
APP_URL=http://≪%DNSorIP%≫:8000
APP_TIMEZONE=America/New_York
APP_LOCALE=en
MAX_RESULTS=500
#
# REQUIRED: UPLOADED FILE STORAGE SETTINGS
#
PRIVATE_FILESYSTEM_DISK=local
PUBLIC_FILESYSTEM_DISK=local_public
#
# REQUIRED: DATABASE SETTINGS
#
DB_CONNECTION=mysql
DB_HOST=db
DB_DATABASE=snipe_it
DB_USERNAME=snipe_it_rw
DB_PASSWORD=Snip3-IT!
DB_PREFIX=null
#
# REQUIRED: OUTGOING MAIL SERVER SETTINGS
#
MAIL_DRIVER=smtp
MAIL_HOST=smtp.i12bretro.local
MAIL_PORT=25
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDR=snipe-it@i12bretro.local
MAIL_FROM_NAME=Snipe-IT
MAIL_REPLYTO_ADDR=snipe-it@i12bretro.local
MAIL_REPLYTO_NAME=Snipe-IT
MAIL_AUTO_EMBED_METHOD=attachment
03. Press CTRL+O, Enter, CTRL+X to write the changes to .env
04. Continue with the following commands in terminal
# set owner of docker directory
sudo chown $USER:$USER ~/docker -R
# set permissions on docker directory
sudo chmod g+rwx $HOME/docker -R
# run the mariadb docker container
docker run -d name mariadb network snipeit network-alias db -e MYSQL_ROOT_PASSWORD=r00tp@ss -e MYSQL_USER=snipe_it_rw -e MYSQL_PASSWORD=Snip3-IT! -e MYSQL_DATABASE=snipe_it -v ~/docker/mariadb:/var/lib/mysql restart=unless-stopped mariadb:latest
# run the snipeit container
docker run -d name snipeit -p 8000:80 network snipeit env-file=$HOME/docker/snipeit/.env -v ~/docker/snipeit/data:/var/lib/snipeit -v ~/docker/snipeit/config:/config restart=unless-stopped snipe/snipe-it:v5.1.7
Snipe-IT Web Installer
01. Open a web browser and navigate to http://DNSorIP:8000
02. Review the Pre-Flight Checks summary ≫ Click the Next: Create Database Tables button
....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 Running Snipe-IT in Docker](https://i.ytimg.com/vi/EsCh0gOrxqE/mqdefault.jpg)
![Run Easy!Appointments - Appointment Scheduler System - in Docker
#EasyAppointments #Scheduling #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0949.html
What is Easy!Appointments?
Easy!Appointments is a highly customizable web application that allows customers to book appointments with you via a sophisticated web interface. Moreover, it provides the ability to sync your data with Google Calendar so you can use them with other services. It is an open source project that you can download and install even for commercial use. Easy!Appointments will run smoothly with your existing website as it can be installed in a single folder of the server and of course share an existing database. - https://github.com/alextselegidis/easyappointments#about
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 Easy!Appointments
01. Now that Docker is installed, run the following commands to setup the Easy!Appointments Docker container and run it
# create working directories
mkdir ~/docker/mariadb -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=easy_appointments_rw -e MYSQL_PASSWORD=EasyAppo1ntm3nts! -e MYSQL_DATABASE=easy_appointments -v /home/$USER/docker/mariadb:/var/lib/mysql restart=unless-stopped mariadb:latest
# run the easy!appointments docker container
docker run -d name easy-appointments network containers -p 8089:80 -e DB_HOST=mariadb -e DB_NAME=easy_appointments -e DB_USERNAME=easy_appointments_rw -e DB_PASSWORD=EasyAppo1ntm3nts! restart=unless-stopped alextselegidis/easyappointments
Easy!Appointments Web Installer
01. Open a web browser and navigate to http://DNSorIP:8089
02. The Easy!Appointments Installation web installer should be load
03. Complete the Administrator and Company form fields ≫ Click Install Easy!Appointments
04. Welcome to Easy!Appointments
Documentation: https://hub.docker.com/r/alextselegidis/easyappointments
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run Easy!Appointments - Appointment Scheduler System - in Docker](https://i.ytimg.com/vi/FDdDQinpzq4/mqdefault.jpg)
![Run MkDocs - Read the Docs Alternative - in Docker
#MkDocs #Containers #Docker
Full steps can be found at https://i12bretro.github.io/tutorials/0986.html
What is MkDocs?
MkDocs is a fast, simple and downright gorgeous static site generator thats geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. It is designed to be easy to use and can be extended with third-party themes, plugins, and Markdown extensions. - https://github.com/mkdocs/mkdocs
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 MkDocs
01. Now that Docker is installed, run the following commands to setup the MkDocs Docker container and run it
# create working directory
mkdir ~/docker/mkdocs
# 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/mkdocs
# run mkdocs container
docker run -d name=mkdocs -p 8000:8000 -v ~/docker/mkdocs/:/mkdocs restart=unless-stopped polinux/mkdocs
02. Open a web browser and navigate to http://DNSorIP:8000
03. Welcome to MkDocs running in Docker
Read the Docs Theme
01. Back in the terminal, continue with the following commands
# stop the container
docker stop mkdocs
# edit the mkdocs configuration file
sudo nano ~/docker/mkdocs/mkdocs.yml
02. Add the following line to mkdocs.yml
theme: readthedocs
03. Press CTRL+O, Enter, CTRL+X to write the changes
04. Run the following command to see the change
# restart the container
docker start mkdocs
05. Back in the web browser, refresh the mkdocs page
Source: https://www.mkdocs.org/getting-started/
Documentation: https://hub.docker.com/r/polinux/mkdocs
### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro Run MkDocs - Read the Docs Alternative - in Docker](https://i.ytimg.com/vi/Fnx8w_uqyuM/mqdefault.jpg)