michaing / dietpi

Lightweight justice for your single-board computer!

Lightweight justice for your single-board computer!

optimised • simplified • for everyone

Website • Downloads • Documentation • Forum • Blog

---

Ready to run optimised software choices with dietpi-software
Feature-rich configuration tool for your device with dietpi-config.

---

Introduction

DietPi is an extremely lightweight Debian-based OS. It is highly optimised for minimal CPU and RAM resource usage, ensuring your SBC always runs at its maximum potential.

The dietpi programs use lightweight whiptail menus. You'll spend more time enjoying DietPi and applications you need and less time staring at the command line.

Use dietpi-software to quick and easy install Ready to Run & Optimised applications for your system. DietPi will do all the necessary configurations, including starting the services. Few highlights: Desktop Environments, Remote Desktop Access, Media Systems & Players, BitTorrent & Downloading, Cloud & Backup, Gaming & Emulation, Social & Search, Camera & Surveillance, Networking, System Stats & Management, Home Automation, Hardware & Voice Projects, Webserver Stacks, DNS Servers / Pi-hole, File Servers, Printing and much more.

Use dietpi-services to control which installed software has higher or lower priority levels (nice, affinity, policy scheduler).

dietpi-update automatically checks for updates and informs you when they are available. Update instantly, without having to write a new image. DietPi automation allows you to completely automate a DietPi installation with no user input, simply by configuring dietpi.txt before powering on.

The DietPi Project Team

The full list of code contributors can be viewed here.

Contributors

Micha

Joined Q3 2017

Project lead (20/02/2019 and onwards), source code contributor, bug fixes, software improvements, DietPi forum administrator.

Daniel Knight

Project founder and previous project lead (19/02/2019 and previous), source code contributor and tester.

JohnVick

Joined 2016-06-08

DietPi forum co-administrator, management, support, testing and valuable feedback.

sal666

Joined 2017-07-26

Creator and maintainer of the first Clonezilla based installer images for x86_64 UEFI systems.

Joulinar

Joined Q4 2019

DietPi forum moderator, support, testing, bug reports + investigation and valuable feedback.

StephanStS

Joined Q4 2019

NanoPi image creator, tester and bug reports.

Petru

Joined 2020-05-31

DietPi documentation author, product manager, SEO and DietPi visibility recommendations.

ravenclaw900

Joined 2020-10-11

Source code contributor, creator of the DietPi-Dashboard and many software implementations.

yumiris

Joined 2018-04-16

Creator and maintainer of the first DietPi Hyper-V images.

---

Collaborations

DietPi + Amiberry

Since 2016-09-02

Joint venture to bring you the ultimate Amiga experience on your SBC, running lightweight and optimised DietPi at its core: #474

---

Hall of Fame

K-Plan

Joined 2016-01-01

Contributions to the DietPi in general, in-depth testing, bug finding and valuable feedback, forum moderator.

ZombieVirus

Joined 2016-03-20

DietPi forum moderator and version history maintainer on forums.

Rhkean

Joined 2018-03-01

Contributions to the DietPi in general, including source code, testing, new devices, forum moderator.

Pilovali

Joined 2015-10-10

Provided dietpi.com web hosting for 1 year until April 17th 2016. Additionally: forum moderator, testing, bug reporting.

Xenfomation

Joined 2016-04-01

Contributions to the DietPi in general, including source code and VirtualBox image creation/conversion.

AWL29

Joined 2016-10-01

Created the first DietPi image for NanoPi M3/T3.

---

Contributing

Git coders, please use the active development branch: dev

• How to add a new software title to DietPi-Software

Are you able to:

• Provide feedback and/or test areas of DietPi, to improve the user experience?
• Report bugs?
• Improve/add more features to the DietPi website or documentation?
• Compile software for our supported SBCs?
• Contribute to DietPi with programming on GitHub?
• Suggest new software that we can add to the dietpi-software install system?

If so, let us know! We are always looking for talented people who believe in the DietPi project, and, wish to contribute in any way you can.

• Send us an email: [email protected]
• Join our forum: https://dietpi.com/forum/
• GitHub: https://github.com/MichaIng/DietPi

Also read our contribute page for an overview of way to support DietPi.

License

DietPi Copyright (C) 2023 Contributors

• Email: [email protected]
• Website: https://dietpi.com/

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/

Links

DietPi Source

• Source: https://github.com/MichaIng/DietPi
• Build: Not applicable, as DietPi uses Bash scripts only, no building or compiling is required.

DietPi Files

• All files located in (recursively):
  • /var/lib/dietpi/
  • /var/tmp/dietpi/
  • /boot/dietpi/
• /boot/dietpi.txt
• /boot/config.txt (RPi)
• /boot/boot.ini (Odroid)
• All files prefixed with: dietpi-

The above GPLv2 documentation also applies to all mentioned files!

3rd Party Sources/Credits

Links to hardware and software manufacturers, sources and build instructions used in DietPi:

• Linux kernel
• GNU operating system
• Bash
• Debian distribution
• Raspberry Pi
• Hardkernel
• Meveric's Odroid repository
• Sparky SBC
• PINE64
• FriendlyARM
• Radxa
• Armbian
• curl
• X.Org-X-Server
• LXDE desktop
• LXQt desktop
• Xfce desktop
• MATE desktop
• GNUstep
• Chromium
• Kodi/XBMC
• Transmission
• rTorrent
• ruTorrent
• qBittorrent
• Nextcloud
• ownCloud
• Syncthing
• ReadyMedia
• MPD
• ympd
• myMPD
• Apache
• Nginx
• Lighttpd
• PHP
• PHP OPcache GUI
• MariaDB
• phpMyAdmin
• Certbot
• Pi-hole
• WordPress
• phpBB
• ProFTPD
• vsftpd
• Samba
• NFS
• Dropbear
• OpenSSH
• OpenVPN
• PiVPN
• WireGuard
• Amiberry
• OpenTyrian
• RPi Cam Web Interface
• Deluge
• Airsonic-Advanced
• Logitech Media Server
• Squeezelite
• Ampache
• Plex Media Server
• Tautulli
• FFmpeg
• Shairport Sync
• FreshRSS
• Folding@Home
• Medusa
• Grafana
• Clonezilla
• Gitea
• Gogs
• Home Assistant
• TasmoAdmin
• Domoticz
• Jellyfin
• Komga
• HTPC Manager
• Bazarr
• PaperMC
• Unbound
• vaultwarden
• Docker
• Portainer
• Tor
• Docker Compose
• Box86
• Box64
• Steam
• mjpg-streamer
• IPFS
• CUPS
• Go
• VSCodium
• WebIOPi
• WiringPi
• Firefox
• Beets
• frp
• AdGuard Home
• Snapcast
• K3s
• Synapse
• youtube-dl
• PostgreSQL
• OpenJDK
• Blynk Server
• File Browser
• Spotifyd
• DietPi-Dashboard
• MicroK8s
• Allo GUI
• PHP Composer
• motionEye
• Sonarr
• Radarr
• Lidarr
• Prowlarr
• Readarr
• Jackett
• HAProxy
• Prometheus Node Exporter
• Prometheus RPi Exporter
• Tailscale
• Rclone
• ZeroTier
• Navidrome
• Homer
• microblog.pub
• Nukkit
• openHAB
• Moonlight (CLI)
• Moonlight (GUI)
• Restic
• MediaWiki
• Homebridge
• ADS-B Feeder
• Kavita

---

DietPi's web hosting is powered by myVirtualserver.

dietpi's Issues

/DietPi/config.txt does not contain the actual config.txt, despite what it claims

$ cat /DietPi/config.txt
This file has been moved to DietPi-Ramdisk.
New location = /DietPi/config.txt

DietPi installation option for PiHole

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=49#p155

DietPi-Software | Update DietPiCam to 6.0.9

Rewrite installation to install latest version 6.0.9
http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=87&p=300#p300

DietPi-Config | Add CPU/ARM min frequencies for RPi

https://www.raspberrypi.org/forums/viewtopic.php?p=819840#p819840

DietPi-Software | Mailserver

lightweight Mailserver such as nullmailer
http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=88

postfix dovecot plus webmail
https://www.raspberrypi.org/forums/viewtopic.php?p=824649#p824649

Install behind proxy

I am trying to install DietPi behind a proxy. So far I did the following:

1. copy image V70 to SD with dd
2. quit the installer after booting
3. set up proxy in /etc/environment, /etc/profile, and /etc/apt/apt.conf.d/10proxy, reboot

At this point, apt-get update is working from the command line. However, the installer hangs with the message "Waiting for apt-get update to finish: Please wait ..."

4. run dietpi-update to upgrade to V73

Still the same problem.

Regards, Marc

DietPi-Software | Single File PHP Gallery

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=135&p=468#p465

bugreport-b827ebb975a0-0 | DietPi-Config > Language > Keyboard (Jessie)

Going into setup and "Language and Regional Options" and choosing
Keyboard, the next menu do not appear, and i end back in "Language
and regional options"

Get this error twice
update-rc.d: warning: start and stop actions are no longer supported; falling back to defaults
update-rc.d: warning: start and stop actions are no longer supported; falling back to defaults

Services Fails after Reboot

Hello,

ive freshly installed dietpi - its amazing. But if i reboot, apache2, munin... and others arent starting.
i have manually start them. Is this coused by the fact, that the logs are at the ram?

Is it possible to set a "slowdown" for the services, after all system tasks has been loaded?

Greetings.

DietPi-Software | Add PhpSysInfo installation option.

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=122&p=435#p427

NB: to replace unsupported Raspcontrol for RPi - Jessie.

webiopi-passwd breaks future webiopi logins

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=55&p=201#p201

Using webiopi-passwd to change password prevents future logins.

DietPi Debian Jessie release.

Is it's save to dist-upgrade to debian jessie?!?

And when will this project switched to jessie?

DietPi-Software | DHCP server installation option.

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=102#p365

DietPi-Software | Add Wordpress installation option.

DietPi-Software | Add Wi-Fi hostspot installation option

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=35&p=200#p197

Notes:

• DietPi-config must be redesigned to allow two active network adapters
• /etc/networking/interfaces . Must change the way we read/write static IP's. Currently we sed both as a shared value. May need to read specific lines for each adapter using sed 1p etc.
• This also requires all DietPi scripts with networking to be checked and recoded as required.

Kernel Panic

Since the last Update, suddenly i got a kernel panic.

I cant connect via SSH.
Via HDMI, there only Shows the Kernel Panic message...

I got a clone from the SDCARD. If you want, i can upload it to any Hoster.
All my Datas are lost, im little bit angry...

Greetings.

DietPi-Software | Update SoftEther installation to latest.

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=111&p=397#p397

Support for qwertz login.

the default root password is "raspberry"... Nice. But on german keyboard with "english" layout you have to remember that "y" is under "z" key...

so, maybe it is a better idea to change the default to something else or set the keyboard layout before first login is needed...

Backup the whole OS remotely while it's running.

https://www.raspberrypi.org/forums/viewtopic.php?p=802054#p802054

rSync.

Add IPv6 support

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=89&p=320#p315

Driver for DWA-182 rev. C

This wifi module has linux drivers from the manufacturer. I attempted to download and compile them, but it's not clear to me where to get the correct linux-headers from. There doesn't seem to be a package available.

I am running DietPi V98, and have done rpi-update to get the latest firmware.

root@benchpi:~# uname -a
Linux benchpi 4.1.11+ #822 PREEMPT Fri Oct 23 16:14:56 BST 2015 armv6l GNU/Linux

My first priority would be to figure out how to compile these drivers. Afterwards it would be nice to have them included in DietPi for others' benefit.

error while loading shared libraries: libidn.so.11: wrong ELF class: ELFCLASS64

This error suddenly appears + segmentation fault at apt-get....

i think i switch to a stable version of the raspberry os

Network setup with German locale

If the locale is set to de-de-UTF8 in the config dialog prior to setting up a static network address, there are erroneous strings prepended to the ip address and mask, i.e. instead of

192.168.0.1

the installer writes

Adresse:192.168.0.1

into /etc/network/interfaces

Upgrate dist from Wheezy to Jessie

Hello, your work is amazing!
I have one question. Is it possible to upgrade with safety dist from Wheezy to Jessie on clear installation, after first run?

DietPi-Software | Use sources.list for internet url tests

https://www.raspberrypi.org/forums/viewtopic.php?p=821247#p821247

bugreport-b827eb6013c0-0 - Jessie | Transmission 403 unauthorized.

DietPi : Bug Report
08-10-2015

Email address = HIDDEN
Name = Lloyd

Transmission daemon 403 unauthorized.

When does the issue occur?
transmission is returning 403 on web ui. whitelist is disabled.
transmission doesnt appear to be actually using settings.json

Pi not updating to v96.

I run the dietpi-update command and everything works and it tells me to reboot but once I reboot it displays v94 and that there is a new update

Image | DietPi for Odroid XU3/4

Hi,
Thanks for your work on DietPi for the C1. I was wondering if there were any plans for an Odroid XU3/XU4 release.
Best,
MZ

DietPi-Config | Add i2c/spi and other hardware options for RPi's

http://fuzon.co.uk/phpbb/posting.php?mode=quote&f=9&p=560#pr560

Syntax error in dietpi-config

To reproduce:

Connected via SSH, no connection to the outside world.

Hitting "Test network" in the network config menu results in this:

cat: /DietPi/dietpi/.installed: No such file or directory
/DietPi/dietpi/dietpi-config: line 1332: ((: == 2 : syntax error: operand expected (error token is "== 2 ")
cat: /DietPi/dietpi/.installed: No such file or directory
/DietPi/dietpi/dietpi-config: line 1352: ((: == 2 : syntax error: operand expected (error token is "== 2 ")
cat: /DietPi/dietpi/.installed: No such file or directory
/DietPi/dietpi/dietpi-config: line 1369: ((: == 2 : syntax error: operand expected (error token is "== 2 ")

Testing connection to http://mirrordirector.raspbian.org, please wait.....

Minor issue, doesn't seem to negatively impact anything.

bug report 0013ef1019eb-0 : Can't connect deluge deamon on windows client remote

I can't connect to my RPI2 dietpi V97 deluge with my Windows 10 deluge client.

When I configure the client, the deamon appear not start
I can connect to the webui

[Wish List] Convert DietPi-Software into SQL database

• Create SQL database (I currently lack the knowledge to do this)
• Move all the installation flags/methods/descriptions into a clean global SQL database.
• Rewrite dietpi-software to use an array system and read directly from SQL database.

MT7601 wifi dongle

Is tehre something wrong with the drivers for this device?

I connect it to my Pi, fresh DietPi v94 Jessie install, no optimized software.

dmesg gives me this:

[  323.845154] usb 1-1.4: new high-speed USB device number 8 using dwc_otg
[  323.956490] usb 1-1.4: New USB device found, idVendor=148f, idProduct=7601
[  323.956514] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[  323.956531] usb 1-1.4: Product: 802.11 n WLAN
[  323.956546] usb 1-1.4: Manufacturer: MediaTek
[  323.956562] usb 1-1.4: SerialNumber: 1.0
[  324.035135] usb 1-1.4: reset high-speed USB device number 8 using dwc_otg
[  324.138207] mt7601u 1-1.4:1.0: ASIC revision: 76010001 MAC revision: 76010500
[  324.139714] mt7601u 1-1.4:1.0: Direct firmware load for mt7601u.bin failed with error -2
[  324.140411] mt7601u: probe of 1-1.4:1.0 failed with error -2

I copied that file mt7601u.bin from the official Raspbian to /lib/firmware and then it worked:

[   32.405209] usb 1-1.4: new high-speed USB device number 5 using dwc_otg
[   32.516566] usb 1-1.4: New USB device found, idVendor=148f, idProduct=7601
[   32.516589] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[   32.516606] usb 1-1.4: Product: 802.11 n WLAN
[   32.516622] usb 1-1.4: Manufacturer: MediaTek
[   32.516638] usb 1-1.4: SerialNumber: 1.0
[   32.612980] cfg80211: Calling CRDA to update world regulatory domain
[   32.795214] usb 1-1.4: reset high-speed USB device number 5 using dwc_otg
[   32.898218] mt7601u 1-1.4:1.0: ASIC revision: 76010001 MAC revision: 76010500
[   32.906620] mt7601u 1-1.4:1.0: Firmware Version: 0.1.00 Build: 7640 Build time: 201302052146____
[   33.306414] mt7601u 1-1.4:1.0: Warning: unsupported EEPROM version 0d
[   33.306438] mt7601u 1-1.4:1.0: EEPROM ver:0d fae:00
[   33.558164] ieee80211 phy0: Selected rate control algorithm 'minstrel_ht'
[   33.559898] usbcore: registered new interface driver mt7601u

Is it supposed to work like this?

General | Install Fail2Ban for all DietPi systems, as default.

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=123&p=436#p428

NB: prevents brute-force attacks by banning IP address

Reboot causes two Subsonic processes to be spawned

When I reboot Dietpi it returns to two subsonic processes showing in htop (which causes jetty to fail - I get a 503 error when trying to connect to the web interface) seems I have to kill both of them and do 'service subsonic start' to get it going properly.

Also I think the minimum memory size you've allocated in subsonic_args is a little too small as I was getting audio dropouts even in Jukebox mode (with no transcoding) - I've increased mine to 350 and it's smooth now, that may be overkill but I would suggest bumping it back up to maybe 150?

DietPi installation option for SubSonic

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=31&start=10#p169

DietPi-Software | Add OpenVPN installation option.

http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=105&p=373#p373

install a little confusing...

The first start (after some reboots) will end in:

• choose software you want to install
• dietpi-config

So i answer the questions like which software to install...
Then i use dietpi-config and configurate everything... But then it will reboot, so that changes are made...

But then i'm back on the same "select software" GUI... and my answers (made before) are gone and i must select my software again...

that is confusing ;)

Squeezebox (LMS). Wont start, 100% cpu usage.

Initial report

https://www.raspberrypi.org/forums/viewtopic.php?p=809287#p809287

My results

https://www.raspberrypi.org/forums/viewtopic.php?p=809932#p809932

Further test results

https://www.raspberrypi.org/forums/viewtopic.php?p=811954#p811954

LMS Forum

http://forums.slimdevices.com/showthread.php?104266-LMS-don-t-start-on-Raspbian-%28DietpPi-Distribution%29

text menu flow...

I think all text menu is some kind of strange in usage flow...

The usage is a little "unnaturally"... From the sequential arrangement...

DietPi-Software | Add Redis installation option

Please consider adding Nginx 1.8 not LEMP stack (latest stable) install option, and Redis 3.0.X (repo has old 2.4 option).

Btw. I have few sketches of design, so next week I'll add them inside design issue.

Dietpi-update 404 error

Hi Fourdee,
Since about a week it seems not possible anymore to run the dietpi update script on my rpi2.
I'm able to ping the host so it doesn't seem like a local network issue.

D I E T - P I | 05:43 | Sun 07/12/2015 ─────────────────────────────────────── V75 | Raspberry Pi 2 (1GB) ─────────────────────────────────────── DietPi-Update: Checking for DietPi updates, Please wait... --2015-07-12 05:43:02-- https://raw.githubusercontent.com/Fourdee/DietPi//dietpi/server_version Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 23.235.43.133 Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|23.235.43.133|:443... connected.
HTTP request sent, awaiting response... 404 Not Found 2015-07-12 05:43:06 ERROR 404: Not Found. root@rpi2:~#

Kind regards,

Ronald

DietPi banner clear screen

The dietpi-banner is clearing the screen, making the startup sequence hard to debug

New logo and website

Hello,
congratulations for creating this awesome distro! I'm using it in my company with Rpi2.

I want to help you with:

• Create a modern and clean website for DietPi
• Create a logo for DietPi.

So I have some questions:

• Can I change a shape of logo?
• I think silver and purple are great, but I want to make full scheme for better identity
• Can I change typography?

DietPi-Software | Add HAproxy installation option

Hello Daniel,
I use DietPi and it's works very good, many thanks for your work.
Could you add HAPROXY software ?
It's very good load balancer and reverse proxy :). I have best options to compile from source for a Rpi, I can sent to you if you need ;).
Thank you,
Jerome

DietPi-Software | Lighttpd webserver stack

Lighttpd + SQLite + PHP5
http://fuzon.co.uk/phpbb/viewtopic.php?f=9&t=88

Jessie + Subsonic - FFmpeg binaries.

Just testing the new Jessie image, it seems that upstream have removed ffmpeg (replaced with libav - which doesn't seem to be a 'diet' solutions...)

DietPi-Config | Add ZRAM-Swap Configure

Currently only supports swapfile want to support zram-swap

see https://www.raspberrypi.org/forums/viewtopic.php?t=19255&p=189838

ramlog fail to start

While booting a DietPi+WebServer (version 57 on Pi type B), the apache2 server seems to be started before ramlog:

`[FAIL] Starting ramlog-tmpfs 2.0Error: /var/log is in use... failed!
The list of open files: (You need to close below daemons if you want to start/stop ramlog manually)

COMMAND  PID     USER   FD   TYPE DEVICE SIZE/OFF   NODE NAME
apache2 1688     root    2w   REG  179,2     1751 135108 /var/log/apache2/error.log
apache2 1688     root    6w   REG  179,2        0 135109 /var/log/apache2/other_vhosts_access.log
apache2 1688     root    7w   REG  179,2     1935 135107 /var/log/apache2/access.log
apache2 1746 www-data    2w   REG  179,2     1751 135108 /var/log/apache2/error.log
apache2 1746 www-data    6w   REG  179,2        0 135109 /var/log/apache2/other_vhosts_access.log
apache2 1746 www-data    7w   REG  179,2     1935 135107 /var/log/apache2/access.log

Test result: ramlog cannot be started or stopped at the moment.

Enable UART login by default

For headless and networkless setup. Connecting to the UART pins on the GPIO headers with a bridge allows you to read the boot log, but actually logging in and using it as a terminal requires some tweaking.

I believe I was able to do this in v61 by changing cmdline.txt to:

dwc_otg.lpm_enable=0 console=tty1 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 elevator=deadline root=/dev/mmcblk0p2 init=/bin/systemd rootfstype=ext4 rootwait

And uncommenting the last line in inittab.

This results in additional startup text that may not be desirable, so there might be a better way of doing this.

Additionally, I was not able to get this working with v81, so either something change, or I have forgotten a step.