DietPi-Software | Details for ALL installation options

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/dietpi_tools/#configuration

DietPi-Sync Details:
DietPi-Sync is a program that allows you to duplicate (sync) a directory from one location (Source) to another (Target).

For example:
If we want to duplicate (sync) the data on our external USB HDD to another location, we simply select the USB HDD as the source, then, select a target location. The target location can be anything from a networked samba fileserver, or even a FTP server.
When we run the sync, the USB HDD data will be duplicated at our selected target.

Launch DietPi-Sync:

Code: Select all

dietpi-sync

Add custom Include and Exclude patterns:
NB: Requires DietPi v6.15
DietPi-Sync uses a set of global include and exclude filters. After running dietpi-sync at least once, please view/edit the following file for more details
- Include/exclude file = /DietPi/dietpi/.dietpi-sync_inc_exc


>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/dietpi_tools/#miscellaneous

DietPi-Morsecode Details:
Imagine your stranded on a boat:
- It has a power failure and its midnight.
- No cellphone coverage or radio.
- No flares.
- The only thing you have with you is a Raspberry Pi, 7inch screen and a battery supply.

But how do you send a message?

This is where DietPi-Morsecode comes in:
It will read your text file, convert it to morse code, then output to your screen using white and black. It could save your life!

dietpi-morsecode.png (9.16 KiB) Viewed 119848 times

Create a text file to be read:

Code: Select all

echo -e "This file will be read by DietPi-Morsecode and converted into morse code." > "$HOME/dietpi-morsecode"

Run DietPi-Morsecode on current screen / term:
This will convert your text file into morsecode and display it on the screen.

Code: Select all

dietpi-morsecode
echo -e "\e[0m" && clear

Run DietPi-Morsecode on the main screen:
This will convert your text file into morsecode and display it on the main screen.

Code: Select all

dietpi-morsecode &> /dev/tty1
echo -e "\e[0m" &> /dev/tty1

Run DietPi-Morsecode using the RPi LED status lights:
This will convert your text file into morsecode and display it using the LED lights.

Code: Select all

dietpi-morsecode 1

>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/social/#wordpress

Wordpress Details:
WordPress is a state-of-the-art semantic personal publishing platform with a focus on aesthetics, web standards, and usability. Allowing you to create your own website.

Access Web Interface:
URL = http://192.168.0.100/wordpress

The first time you connect, enter the following MySql database details:
Database name = wordpress
User Name = wordpress (Previous to DietPi v6.0 = root)
Password = <your global application pw>
Database Host = localhost
Table Prefix = wp_


>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/remote ... vnc-server

TigerVNC Server
Run a desktop environment on your device that can be accessed remotely, over the network. Great for headless devices.

VNC servers start automatically during boot, unless you have selected "Desktop" as a dietpi-autostart option.
You can control the VNC service with:

• systemctl status vncserver

Connection Details:

• Use the IP address of your DietPi device (e.g.: 192.168.0.100)
• If you can't connect, try connecting to screen 1 (e.g.: 192.168.0.100:1)
• Password = The password you entered during installation.
• Change Password = Run vncpasswd from the console/terminal.
• The default port is 5901, thus this needs to be forwarded from your router to allow access from outside your local network.

Setup a VNC Viewer (Windows):
Simpy select a VNC viewer for your system and download: https://www.realvnc.com/download/viewer/
Run the VNC viewer and enter the IP address of your DietPi device to begin the remote session.

Optional: Change VNC Server options

• Edit dietpi.txt

  Code: Select all

  nano /boot/dietpi.txt

• Run VNC server in shared desktop mode:

  Code: Select all

  SOFTWARE_VNCSERVER_SHARE_DESKTOP=1

  A running desktop is required in this mode, please set desktop to start from boot:

  Code: Select all

  dietpi-autostart

• Run VNC server on screen :1, creating a new desktop with 1280x720 resolution:

  Code: Select all

  SOFTWARE_VNCSERVER_WIDTH=1280
  SOFTWARE_VNCSERVER_HEIGHT=720
  SOFTWARE_VNCSERVER_DEPTH=32
  SOFTWARE_VNCSERVER_DISPLAY_INDEX=1

• Restart service:

  Code: Select all

  systemctl restart vncserver

>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/system ... phpsysinfo

PhpSysInfo Details:
Allows you to monitor your system stats from a webpage.
- Also Installs: LASP Webserver

Access PhpSysInfo:
url = http://192.168.0.100/phpsysinfo


>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/system ... /#fail2ban

Fail2Ban Details:
Protects your system from brute-force attacks, by banning the source IP address. We have enabled detection for SSH servers (OpenSSH and Dropbear), however, fail2ban also supports additional software.

fail2ban-logo.jpg (23.72 KiB) Viewed 119294 times

When is a IP address ban triggered?
By default, after 3 failed SSH login attempts, fail2ban will ban the source IP address for 10 minutes.

Check status of fail2ban block activity:

Code: Select all

fail2ban-client status sshd
fail2ban-client status dropbear

Enable support for additional programs:
Fail2Ban supports brute-force protection for other software (eg: Apache, proftpd etc).
You can enable/disable these features by modifiying the /etc/fail2ban/jail.conf file, and setting enable = true under the [software] name.


>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/social ... hp-gallery

Single File PHP Gallery:
Allows you to host and browse your images from a web interface.
- Also Installs: LASP Webserver

Access Image Gallery:
url = http://192.168.0.100/gallery

How to add your own images:
- Create your image folder

Code: Select all

mkdir /var/www/gallery/MyImageFolder

- Put a image file inside your new folder

Code: Select all

wget http://media.moddb.com/cache/images/articles/1/153/152601/crop_120x90/download.png
mv download.png /var/www/gallery/MyImageFolder/

>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/media/#ampache

Ampache
A web based audio/video streaming application and file manager allowing you to access your music & videos from anywhere, using almost any internet enabled device.
- Also Installs: Webserver stack

Access Ampache web interface:
url = http://192.168.0.100/ampache
username = admin
password = dietpi

Transfer Media files to Ampache:
- Make sure you have one of DietPi's File Servers installed.
- Folders used by Ampache = /mnt/dietpi_userdata/Music /mnt/dietpi_userdata/Video

Scan for media, update Ampache database:
DietPi will automatically add various catalogue directories to Ampache during installation. You can modify these directories as needed before running your first scan.
To start the scan and import your media into Ampache:
- Select the admin button.
- Select show catalogues from the left hand side.
- Select Update all.

Add custom media folders:
- Select the admin button.
- Select add a catalogue from the left hand side.
- Enter the details of your path (See the image example below to add your USB drive music folder to Ampache."
- Select the add catalogue button.
NB: For Ampache to access custom directories, you must ensure read access to the folder.
eg:

Code: Select all

chmod -R 775 /my/directory

Enable additional file formats via transcoding:
- https://github.com/ampache/ampache/wiki/Transcoding
- E.g. to allow .m4a playback:

Code: Select all

G_CONFIG_INJECT 'transcode_m4a[[:blank:]]' 'transcode_m4a = allowed' /var/www/ampache/config/ampache.cfg.php

Update Ampache to current version: dietpi-software reinstall 40


>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/software/vpn/#openvpn

OpenVPN Server

An easy to use VPN server and client system. The DietPi installation of OpenVPN uses a single client file to get you connected with minimal hassle.

Obtaining the Client connection file (DietPi_OpenVPN_Client.ovpn):
DietPi will automatically generate unique 2048 bit server and client keys during installation and place them into a unified client config file.
You will need this file to connect to your OpenVPN server from a client.

Client file location:

• DietPi will generate the client config file and place it here: /boot/DietPi_OpenVPN_Client.ovpn. Simply power off and plug the SD card into your PC to obtain the file from the FAT partition.
• DietPi will also create a copy of the file in /mnt/dietpi_userdata/DietPi_OpenVPN_Client.ovpn. Use one of DietPi's file servers to access this file.
• Please remove those files after they have been deployed on the client system for security reasons!

Setting up your router for external access:
OpenVPN server uses the following ports:
- TCP 443
- TCP 943
- UDP 1194
These ports must all be enabled in port forwarding on your router, and, pointing to the IP address of your DietPi system.


Download the OpenVPN client programs (Windows):
URL = https://openvpn.net/community-downloads/
Download and install the installer that suites your Windows version.


Change the target address for the client file:
You will need to open the DietPi_OpenVPN_Client.ovpn file in a text editor to change the target domain/ip address. This can be anything from a website address, No-IP domain name, or IP address.

Change mywebsite.com. eg::
remote MySuperDooperWebsite.com 1194
remote 81.252.0.1 1194


Connecting to your OpenVPN server (Windows):
Method 1 - Quick:
Simply right click the DietPi_OpenVPN_Client.ovpn file and choose "Start OpenVPN on this config file".

Method 2 - GUI:
If you want to use the OpenVPN GUI, you will need to copy DietPi_OpenVPN_Client.ovpn to the OpenVPN config location (eg: C:\Program Files\OpenVPN\config).


OpenVPN + Pi-hole:
To allow VPN clients accessing your local Pi-hole instance, you need to allow DNS requests from all network interfaces:
pihole -a -i local

>> Return to DietPi-Software List

[Fourdee]

Deprecation warning: This post is deprecated. Please find our new documentation at: https://dietpi.com/docs/dietpi_tools/#maintenance

DietPi-Cleaner
DietPi-Cleaner is a program that allows you to remove unwanted "junk" from your DietPi system, and free up filespace usage.
Think of it as lightweight CCleaner for DietPi and Linux.

Launch DietPi-Cleaner:

Code: Select all

dietpi-cleaner

Cleaner Types:
DietPi-Cleaner uses modules which you can be switched on or off before running the cleaning process.

Files cleaner
The files cleaner allows you to customize a list of filenames to search and remove, during the cleaning process.

>> Return to DietPi-Software List