Getting started | Download DietPi image

Everything you need to download and start your DietPi experience.
User avatar
Site Admin
Posts: 2779
Joined: Tue Feb 06, 2007 1:36 pm

Getting started | Download DietPi image

Post by Fourdee »

This thread is deprecated, please refer to our new documentation page:

Give your Single-board computer some Lightweight justice. What you'll need:
  • 4GB or greater Micro SD card.
  • Internet Access (Ethernet or Wifi, required to complete the DietPi setup).
  • Dedicated USB Drive is highly recommended (Allows DietPi-Software installations to utilize USB over SD).

Step 1 (Download DietPi Image):
Download -

For experienced users who want to skip this guide and dig straight in.
Here are the login details:
  • username = root
  • password = dietpi

Step 2:
Write to SD card using Etcher:
  • Unzip/extract the DietPi.7z image (ideally your desktop)
  • Download and install Etcher
  • Run Etcher
  • Select the DietPi.img image file
  • Select the drive of your SD card
  • Click Flash!
Write to SD card using Linux:
  • Find the device (eg: /dev/sdb1) you need to write to by using blkid or mount.
  • Double check that you have the correct dev path for your SD card (eg: /dev/sdb1).
  • Unmount the SD card and all its partitions by using umount /dev/sdb?.
  • Write the image using dd if=/path/to/DietPi.img of=/dev/sdb.

Optional (Wifi):
Pre-configure WiFi Details for DietPi
  • Goto my computer, select the SD card and open it.
  • Locate the file called dietpi.txt and open it with wordpad.
  • DietPi_v6.15 and lower images:
    • Enter your SSID AUTO_SETUP_NET_WIFI_SSID=MySSID and AUTO_SETUP_NET_WIFI_KEY=MyWifiKey (both are case sensitive).
  • DietPi_v6.16 and higher images:
    • Open dietpi-wifi.txt and open it with wordpad
    • Change aWIFI_SSID[0]='MySSID' and aWIFI_KEY[0]='MyWifiKey'
  • Save changes to edited files
  • Plug the WiFi adapter into your device, before turning it on.

Step 3:
Turn on your device
  • Plug the SDcard into your device and turn it on.
  • Wait for DietPi to complete some initial setup steps.
  • Once completed, the login screen will appear.

Step 4:
Login to DietPi On first login, DietPi will automatically update.
Due to current reports: If "Checking DNS resolver" fails, this is most likely due to your system or local network setup does not support IPv6 and you did not disable it via dietpi.txt. Please try the following steps:
  • Hit Exit, in case of a second prompt, hit Cancel.
  • Run the following command: /DietPi/dietpi/func/dietpi-set_hardware enableipv6 0
  • Run the following command: /DietPi/dietpi/dietpi-login

The DNS resolving should now succeed.

Once completed, press enter to reboot the system. You can log back in again to resume setup.

Optional (DietPi-Config):
DietPi-Config is a feature rich configuration tool for your device:
  • Set Overclocking Profiles.
  • Setup advanced networking options (static IP / wifi).
  • Mount network filesystem shares (Samba / FTP).
Click here for a complete list of DietPi-Config options.

Optional (Obtain IP Address):
Obtaining your IP address
  • In all the DietPi guides, we use as the IP address. When reading through the online documentation, and you see a URL link or IP address, you will need to use the IP address on your DietPi system.
Click here for details on how to obtain your IP address.

Step 5: Select Software to Install:
Now you can install the software you require, or follow one of the setup guides for popular/combo programs:

DietPi-Software Details for ALL installation options:

Minimal image
If you want a minimal image, simply select Go >> Start install from the menu. This will complete the 1st run setup of DietPi. Additional software can always be installed at a later date.

Additional Help / Setup Guides:

(Setup Guide) Accessing files on your DietPi system:

(Setup Guide) Obtain your IP address:

(Step by Step Guide) DietPi - Kodi + BitTorrent Combo:

(Step by Step Guide) DietPi - Hifi + DLNA Server Combo:
If you find our project or support useful, then we’d really appreciate it if you’d consider contributing to the project however you can.
Donating is the easiest – you can use PayPal or become a DietPi patron.