Software installation¶
DietPi software¶
dietpi-software
will be automatically displayed on the first login after the installation. It can be accessed at any time running next command:
dietpi-software
It is one of the core tools, enabling you to install or uninstall one or more DietPi optimised software titles.
Software overview¶
Begin by selecting Browse Software in the main menu list and hit Enter.
Scroll through the list of available software - for more details check the DietPi software list.
The list of optimised software is long. You either browse the list or use the option Search Software.
To install software on your DietPi, select it in the list and press Space to add it to the installation list. If you change your mind, hit Space again to remove it.
Once you’ve selected the software you wish to install, press Tab to switch to the confirmation options at the bottom. Select OK, then hit Enter to confirm.
To begin installing your software, select Install from the main menu list, then hit Enter. DietPi will ask you to confirm your choice(s). Select OK, then hit Enter to begin the installation.
The software you selected will begin to install at this point. Once the process is completed, you may be asked to restart your device. Press OK to confirm.
DietPi supports a large number of software titles. Instead of scrolling through the Browse Software list to find a specific software title, you may use the Search Software option. Type in the software ID or any keyword from its title or description and you’ll get a list filtered by matching results.
Quick selections¶
This lets you select your preferred SSH server. Also you can uninstall any SSH server to save memory and to exclude any external ssh based access.
Various logging methods can be selected from lightweight to full. If you don’t require log files, get a performance boost. If you need full system logging features, DietPi can do that too.
The Log System can be changed at any time by selecting a different “Log System” from the menu.
See log system choices for further details.
In DietPi, we class user data as:
- Data storage for applications. Some examples are ownCloud/Nextcloud data store, BitTorrent downloads and SQL data store.
- The location where your File Server choice will point to, if you install one, like Samba Server or ProFTPD.
- The location where you can upload and store your media content, for other applications to use, like Kodi, Emby or Plex.
For all software you install in dietpi-software, you can access your user data with /mnt/dietpi_userdata
. Regardless of where the data is physically stored, a symlink will automatically be created for you if needed.
To check where the physical location is, you can run the following command:
readlink -f /mnt/dietpi_userdata
You can move your user data to another location (e.g. USB drive). Simply run dietpi-software
and enter the User data location menu option:
- If you need to setup a new external drive, select Drive Manager to launch DietPi-Drive Manager.
- Use the List option to select from a list of mounted drives, or, select Manual for a custom location.
DietPi will automatically move your existing user data to your new location.
Install or remove software¶
Install software item(s) which have been selected via Browse Software list, via Search Software, or via the SSH Server, File Server or Log System choices.
Select one or more software items which you would like to be removed from your DietPi system.
DietPi Software - Command line usage¶
Beside the interactive software installation via dietpi-software
with checking wanted software packages and installing them, there is the option of installing the software packages via the shell command line:
Usage: dietpi-software [<command> [<software_id>...]]
Available commands:
<empty> Interactive menu
install <software_id>... Install each software given by space-separated list of IDs
reinstall <software_id>... Reinstall each software given by space-separated list of IDs
uninstall <software_id>... Uninstall each software given by space-separated list of IDs
list Print a list with IDs and info for all available software titles
free Print an unused software ID, free for a new software implementation
The <software_id>
which has to be given is the one which is present in the software list within the dietpi-software
dialogues:
E.g. to install Chromium, LXQt and GIMP you have to run next command in the terminal:
dietpi-software install 113 173 174
DietPi LetsEncrypt¶
Access the frontend for the Let's Encrypt
integration by running
dietpi-letsencrypt
Software overview¶
In case of a non installed Certbot package it is installed at first:
In the installation dialog some entries have to be made which are needed for the certificate (domain, Email), the other entries are configuration options. It is recommended to leave the key size at 4096 bits.
When you execute the certificate installation it also installs it for your selected web server, i.e. you do not have to edit your web server configuration files, the installation routine does all for you.
DietPi LetsEncrypt - Command line usage¶
Beside the interactive LetsEncrypt installation via dietpi-letsencrypt
, there is the option of the shell command line:
Usage: dietpi-letsencrypt [<command>]
Available commands:
<empty> Interactive menu
1 Create/Renew/Apply certificates non-interactively
Port forwarding on your router
To be accessible from the internet, typically your router needs a port forwarding configuration to route incoming HTTP and HTTPS accesses to your DietPi system.
Although you only need a HTTPS protocol forwarding (typically port 443), you also need to forward the HTTP protocol (typically port 80) to your DietPi system, otherwise the certification renewal procedure will fail (due to the fact that the certification renewal procedure takes place several months later you may have forgotten this issue).
DietPi VPN¶
DietPi-VPN is a combination of OpenVPN installation and DietPi front end GUI. Allowing all VPN users to quickly and easily connect to any NordVPN, ProtonVPN, or any other server that uses OpenVPN in TCP or UDP, using only open source software. To start DietPi-VPN, use the following command:
dietpi-vpn
Software overview¶
Although we enable forced encryption on all our BitTorrent clients, if you wish to ensure complete privacy and piece of mind for all your downloaded content, using a VPN is critical.
You can use any VPN provider you want, but DietPi-VPN specifically supports ProtonVPN and NordVPN.
Simply run dietpi-vpn
to use the GUI, allowing you to setup your connection and provider.
DietPi will also automatically start and connect the VPN during system boot if you select autostart.
DietPi-VPN comes with an optional killswitch that will shut off your internet in the case of you losing your connection to the VPN sever. This will still allow access from your LAN and allow you to fix any problems using SSH, if needed.
DietPi VPN - Command line usage¶
Beside the interactive VPN installation via dietpi-vpn
, there is the option of the shell command line:
Usage: dietpi-vpn [<command>]
Available commands:
<empty> Interactive menu to control VPN settings and connection
status Print VPN connection status
DietPi DDNS¶
DietPi-DDNS is a generic Dynamic DNS (DDNS) client. It can be used to setup a cron job which updates your dynamically changing public IP address every defined amount of minutes against a DDNS provider, so that your public domain stays valid. It supports No-IP and replaces the No-IP client, which was available as install option on previous DietPi versions. To start DietPi-DDNS, use the following command:
dietpi-ddns
Supported providers¶
- DuckDNS: https://www.duckdns.org/
- No-IP: https://www.noip.com/
- Dynu: https://www.dynu.com/
- FreeDNS: https://freedns.afraid.org/
- OVH: https://docs.ovh.com/gb/en/domains/hosting_dynhost/
- YDNS: https://ydns.io/
- Alternatively you may use any other provider which has an API URL for updating your dynamic IP address.
DietPi DDNS - Command line usage¶
Beside the interactive DDNS installation via dietpi-ddns
, there is the option of the shell command line:
Usage: dietpi-ddns [[<options>...] <command> [<provider>]]
Available commands:
<empty> Interactive menu to setup dynamic DNS updates
apply <provider> Apply or update DDNS updates for <provider>, using
<options> for setup details
remove Remove any DDNS updates from this system
Available options:
-d <domains> Comma-separated list of domains that shall point
to this system
-u <username> Username or identifier, depending on provider
In combination with a custom provider, this is used
for HTTP authentication.
-p <password> Password or token, depending on provider
In combination with a custom provider, this is used
for HTTP authentication.
-t <timespan> Duration between DDNS updates in minutes
(optional, defaults to 10 minutes)
-4and6 Update IPv4 and IPv6 addresses for your DDNS
(optional, the default)
-4 Update only the IPv4 address for your DDNS (optional)
-6 Update only the IPv6 address for your DDNS (optional)
-h Get an overview of supported CLI commands and options
Available providers:
<custom> Full URL to update against a custom DDNS provider
Use the "-u" and "-p" options if HTTP authentication
is required.
DuckDNS Read more: https://www.duckdns.org/about.jsp
Use the "-d" and "-p" options to set domains and
account token.
No-IP Read more: https://www.noip.com/about
Use the "-d", "-u" and "-p" options to set domains,
username and password.
Dynu Read more: https://www.dynu.com/DynamicDNS
Use the "-d" and "-p" options to set domains and
account password.
FreeDNS Read more: https://freedns.afraid.org/
Use the "-p" option to set the account token.
OVH Read more: https://docs.ovh.com/gb/en/domains/hosting_dynhost/
Use the "-d", "-u" and "-p" options to set domains,
username and password.
YDNS Read More https://ydns.io
Use the "-d", "-u" and "-p" options to set the domain,
username and password.
Explanation:
- Use
dietpi-ddns <options> apply <provider>
to apply a cron job for the given provider and given options<provider>
is either the name of a supported provider, or any custom update URL.- If you did already setup DietPi-DDNS before, the
apply
command can also be used to change one of the above settings. All other options are optional then.
- Use
dietpi-ddns remove
to remove any cron job that was setup before.