# Raspberry Pi Zero Headless Quick Start ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/041/066/medium800/raspberry_pi_banner.jpg?1492918856) This guide shows how to bring up a Raspberry Pi Zero, Zero W, or Zero 2 W without needing to attach a keyboard/mouse/monitor. For older Pi OS releases, basic settings can be configured by editing text files directly on the SD card using an editor on your main PC prior to first boot. For newer Pi OS releases, the rpi-imager tool can be used to both burn the OS image and configure settings. Info: # Suggested Items If you need to troubleshoot for any reason, this item is your best friend. For $10, it makes working with a headless Pi Zero so much easier. It's also included with a lot of the kits. [USB console cable.](https://www.adafruit.com/product/954)   Don't leave home without it. ![raspberry_pi_usb_console_cable.jpg](https://cdn-learn.adafruit.com/assets/assets/000/041/003/medium640/raspberry_pi_usb_console_cable.jpg?1492898447) This is a slightly fancier option specifically made for the Pi. It has the convenience of allowing you to use a standard micro USB cable. It was mainly designed for attaching to male headers, so if you've soldered on something different you'll have to find some way to jumper it. [Adafruit PiUART - USB Console and Power Add-on for Raspberry Pi](https://www.adafruit.com/product/3589) ![raspberry_pi_3589-01_small.jpg](https://cdn-learn.adafruit.com/assets/assets/000/046/715/medium640/raspberry_pi_3589-01_small.jpg?1506104136) Of course you'll also need an SD card for the operating system, a Pi Zero ([plus WiFi adapter](https://www.adafruit.com/product/814)) or [Zero W](https://www.adafruit.com/category/813), and some form of header pins to access the GPIO. - [Male Headers](https://www.adafruit.com/product/2822) - [Female Headers](https://www.adafruit.com/product/2222) - [90deg Female Headers](https://www.adafruit.com/product/2823) # But I Want To Connect A Keyboard/Mouse/Monitor That's fine but not covered in this guide. Troubleshooting HDMI issues, configuring display settings, and dealing with possible HDMI and/or USB cable and/or power problems are worth a separate guide. # Other Pi Models This guide is targeted for the Pi Zero and Zero W as those models are more difficult to attach a keyboard / mouse / and monitor to. However, these setup instructions should also work on any Pi with WiFi. It has been tested to work with: - Pi 3 Model B - Pi 3 Model B+ - Pi 3 Model A+ - Pi 4 Model B # Raspberry Pi Zero Headless Quick Start ## Is There Even Life? You can skip this section unless you have reason to believe your Pi Zero isn't alive. Danger: The Pi Zero doesn't have much in the way of blinky LEDs to give you a warm fuzzy that it's doing anything or even alive. And if the GPU doesn't find a valid OS image, it doesn't even turn on the green ACT LED and looks totally dead. Typically this just means something is up with the SD card. Bad card. Bad image. Out of date image. Whatever. **It does not mean the Pi Zero is dead.** ## **Here's how to run a sanity check to verify if the Pi Zero is OK.** (taken from [here](https://www.raspberrypi.org/forums/viewtopic.php?f=28&t=58151) and also provided [here](../../../../introducing-the-raspberry-pi-zero/is-my-pi-zero-dead)) - Take your Zero, with nothing in any slot or socket (yes, **no SD-card is needed** or wanted to do this test!). - Take a normal micro-USB to USB-A **DATA SYNC** cable (not a charge-only cable! make sure its a true data sync cable!) - Connect the USB cable to your PC, plugging the micro-USB into the Pi's USB, ( **_not the PWR\_IN_** ). - If the Zero is alive, your Windows PC will go ding for the presence of new hardware & you should see "BCM2708 Boot" in Device Manager. - Or on linux, run  **sudo lsusb** or run **dmesg** and look for a `ID 0a5c:2763 Broadcom Corp `message. If you see that, so far so good, you know the Zero's not dead. Info: Below is a Pi Zero connected to a Linux computer via a USB cable and the resulting dmesg output. **Note: there is no SD card installed, USB cable is in USB port, and there are no lights.** ![](https://cdn-learn.adafruit.com/assets/assets/000/041/599/medium800/raspberry_pi_sanity_check.jpg?1494359839) This is what a **Pi Zero 2 W** shows up as: ![](https://cdn-learn.adafruit.com/assets/assets/000/106/063/medium800/pi_zero_Screenshot_from_2021-11-01_14-02-56.png?1635800628) Here's what our Windows machine showed: ![](https://cdn-learn.adafruit.com/assets/assets/000/041/830/medium800/raspberry_pi_bcm.png?1495051583) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/831/medium800/raspberry_pi_devmng.png?1495051624) Looks dead, but it's not. # Raspberry Pi Zero Headless Quick Start ## Install OS on to SD Card This guide uses Raspbian Lite as the starting point. Download the latest version from here: [Raspbian Download](https://www.raspberrypi.org/downloads/raspbian/) You will get a .zip file. Unzip that and you should get a .img file. Then follow these excellent instructions to burn the OS image to an SD card: [Raspberry Pi Imaging Tutorial](https://www.raspberrypi.org/documentation/installation/installing-images/README.md) You live in a world where an entire operating system can fit on a wafer thin piece of plastic smaller than your finger tip. And you can run this on a $5 (or $10) computer that is small enough to [give away on the cover of a magazine](https://www.raspberrypi.org/magpi/issues/40/). You should be amazed, excited, and happy about this. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/008/medium800/raspberry_pi_sd_on_finger.jpg?1492899651) # Raspberry Pi Zero Headless Quick Start ## Text File Editing Warning: `Latest OS tested: Raspberry Pi OS Buster Lite 2021-05-07` If you burned the OS image successfully, you should see a folder named **boot** appear on your main computer. If it doesn't, try removing and reinserting the SD card. If it still doesn't, try burning the image again. There are four text files we will create/edit in **boot**. 1. **userconf.txt** - user account id and password 2. **wpa\_supplicant.conf** - wifi settings 3. **config.txt** - global system settings 4. **ssh** - an empty text file to enable ssh We are going to edit these directly on the SD card before putting it in the Pi Zero. This way you can edit these files using your favorite text editor on your main computer. **Try to avoid using a word processor though.** A "text editor" edits text and nothing else, whereas a "word processor" allows for all kinds of formatting, like making text bold, inserting images, etc.  # Create User Account and Password As of the bullseye release of the Raspberry Pi OS, the default account with username pi and password raspberry has been removed. [This blog post has more information.](https://www.raspberrypi.com/news/raspberry-pi-bullseye-update-april-2022/) To create a user account, a file named **userconf.txt** is created that contains the account username and **encrypted** password. The password must be encrypted, which can be a hassle. If you have access to a running Pi or other linux machine, can use the following: ```terminal pi@raspberrypi:~ $ echo "raspberry" | openssl passwd -6 -stdin $6$AAEwDli5NhfHfGpt$Wtvv7DiMGR8mtGn/rDlgn80.MYQ2.bGCBmWrULW75KyTsXNm1vFndSS8TLdlxWZbNMoEuWqlmIwr3f9grFMf5/ ``` The resulting contents of the **userconf.txt** file would then look like: ```terminal pi:$6$AAEwDli5NhfHfGpt$Wtvv7DiMGR8mtGn/rDlgn80.MYQ2.bGCBmWrULW75KyTsXNm1vFndSS8TLdlxWZbNMoEuWqlmIwr3f9grFMf5/ ``` That will create a user account with username **pi** and password **raspberry**. # Configure WiFi The Pi Zero W has built in WiFi so nothing additional is required. **WiFi is only supported on 2.4 GHz band**. If you are using the original Pi Zero, you will need some form of [WiFi Adapter](https://www.adafruit.com/product/814) and a way to connect it: [cable](https://www.adafruit.com/product/1099) or [adapter](https://www.adafruit.com/product/2910). The WiFi configuration file does not exist and needs to be created. The name of the file should be **wpa\_supplicant.conf** and its contents will get copied to the system folder at boot time. It will then be deleted. So this a one time only process. If you want to try again, you have to recreate the file and reboot. The contents of the file should be as shown below. Replace **YOURSSID** and **YOURPASSWORD** with whatever is used for your network setup. ``` ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev update_config=1 country=US network={ ssid="YOURSSID" psk="YOURPASSWORD" scan_ssid=1 } ``` Info: Like this: ![](https://cdn-learn.adafruit.com/assets/assets/000/053/101/medium800/pi_zero_wpa_conf_edit.jpg?1524157537) On the **country=** line, if not in the US, replace with code for your specific country. [Click here for a list of country codes.](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) Save file and move on to next step. ([more details here](https://raspberrypi.stackexchange.com/a/37921)) # Enable UART The file called **config.txt** already exists, we are just going to edit its contents. We will add some text to the bottom to enable the UART on the GPIO header pins. This allows a USB console cable to be attached later for troubleshooting. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/596/medium800/raspberry_pi_open_file.jpg?1494357915) Open the file in a text editor and add the following text to the bottom. ``` # Enable UART enable_uart=1 ``` Like this: ![](https://cdn-learn.adafruit.com/assets/assets/000/041/597/medium800/raspberry_pi_edit_file.jpg?1494357931) Save it and move on to next step. ([more details here](https://www.raspberrypi.org/forums/viewtopic.php?f=28&t=141195)) Info: Add dtparam=uart0_console=on to bootfs/config.txt on latest Pi OS releases. # Enable SSH SSH used to be enabled by default, but was then (Nov 2016) turned off by default. This was due to security concerns since the pi user id and password are well known. However, you'll likely want this enabled so you can remotely connect to the Pi Zero. To do so, we simply create a file called **ssh**. This file does not exist and needs to be created. It can be empty. The system looks for it at boot time and will enable ssh if it is there. It is then deleted. So just create a new file and save it as **ssh** to the **boot** folder. # Final Check After the above steps, you should have the following files on the SD card in the **boot** folder. ![](https://cdn-learn.adafruit.com/assets/assets/000/116/969/medium800/pi_zero_bitmap.png?1670353687) Safely remove the SD card from the main computer and install it in the Pi Zero. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/598/medium800/raspberry_pi_new_sdcard.jpg?1494358340) # Raspberry Pi Zero Headless Quick Start ## Using rpi-imager Warning: This approach uses the **rpi-imager** software created by the Raspberry Pi Foundation. This allows configuring and writing the OS image all in one step. No text file editing required. **This process can do all the same setup except for the UART enabling.** Information on installing and running **rpi-imager** can be found here: [Raspberry Pi Software](https://www.raspberrypi.org/software/) Once you've installed **rpi-imager** and launched it, you should see the initial screen. Configuration settings are accessed via the Advanced Options by clicking on the gear icon: ![](https://cdn-learn.adafruit.com/assets/assets/000/108/977/medium800/pi_zero_rpi-imager-config171.jpg?1644857421) The Advanced Options should look like this: ![](https://cdn-learn.adafruit.com/assets/assets/000/104/340/medium800/pi_zero_Screenshot_from_2021-09-02_15-01-29.png?1630620472) The top drop down lets you choose between applying the settings just once (for this session only) or every time you burn an image (to always use). The later can be useful so you don't have to type in the same information each time you burn an image. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/346/medium800/pi_zero_Screenshot_from_2021-09-02_15-19-59.png?1630621211) And then you can just scroll through and enable any of the options you want and configure as appropriate. Be sure to scroll, there are more items than can fit in the small rpi-imager app window. ## Set Hostname This is the name the Raspberry Pi will show up as on your network. If nothing is done here, the default is **raspberrypi**. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/341/medium800/pi_zero_Screenshot_from_2021-09-02_15-03-06.png?1630620569) ## Enable SSH Not only can you enable SSH, you can set a new password to use as well. By default, SSH is **disabled**. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/343/medium800/pi_zero_Screenshot_from_2021-09-02_15-04-09.png?1630620653) ## Set Username and Password As of the bullseye release of the Raspberry Pi OS, the default account with username **pi** and password **raspberry** has been removed. [This blog post has more information.](https://www.raspberrypi.com/news/raspberry-pi-bullseye-update-april-2022/) To create a user account, fill in the username and password. This can be whatever you want, including the old default **pi:raspberry**. ![](https://cdn-learn.adafruit.com/assets/assets/000/116/968/medium800/pi_zero_raspi-config14.png?1670352822) ## Configure WiFi This sets up the Raspberry Pi to be able to connect to your local WiFi network. Type in your WiFi network name (SSID) and password. Be careful not to have any typos. **Don't forget to also set the country code.** ![](https://cdn-learn.adafruit.com/assets/assets/000/104/344/medium800/pi_zero_Screenshot_from_2021-09-02_15-05-15.png?1630620733) ## Location Settings This can be used to set time zone and keyboard layout. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/345/medium800/pi_zero_Screenshot_from_2021-09-02_15-05-30.png?1630620852) ## Burn OS Image Once done with the settings, click the **SAVE** button to get back to the main rpi-imager screen. Then, pick an OS image by clicking the **CHOOSE OS** button. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/347/medium800/pi_zero_Screenshot_from_2021-09-02_15-23-58.png?1630621527) Most of these options will download the selected image from the internet before burning. If you want to instead use a specific OS image you've already downloaded, then scroll to the very last option - **Use Custom**. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/348/medium800/pi_zero_Screenshot_from_2021-09-02_15-27-27.png?1630621658) Click **CHOOSE STORAGE** to pick the SD card to use. Be careful to select the correct device here. Warning: ![](https://cdn-learn.adafruit.com/assets/assets/000/104/350/medium800/pi_zero_Screenshot_from_2021-09-02_15-28-41.png?1630621873) Then click **WRITE** to start writing the image to the SD card. You'll be prompted to confirm before starting. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/351/medium800/pi_zero_Screenshot_from_2021-09-02_15-32-31.png?1630622000) Click **YES** and away it goes. It will take several minutes to complete. Longer if it also has to download the image first. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/352/medium800/pi_zero_Screenshot_from_2021-09-02_15-33-04.png?1630622023) Once done, you get this pop up, and...well...you're done. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/353/medium800/pi_zero_Screenshot_from_2021-09-02_15-42-50.png?1630622582) ## How It Works This process seems to rely entirely on creating a custom script called **firstrun.sh** in the **/boot** partition of the SD card. It does not create a wpa\_supplicant.conf or ssh file. Nor does it alter config.txt. Here are the contents of the **firstrun.sh** file created after the screen shots above and burning the OS image. **NOTE: The SD card has not been booted in a Pi yet.** ```auto #!/bin/bash set +e CURRENT_HOSTNAME=`cat /etc/hostname | tr -d " \t\n\r"` echo wintermute >/etc/hostname sed -i "s/127.0.1.1.*$CURRENT_HOSTNAME/127.0.1.1\twintermute/g" /etc/hosts FIRSTUSER=`getent passwd 1000 | cut -d: -f1` FIRSTUSERHOME=`getent passwd 1000 | cut -d: -f6` echo "$FIRSTUSER:"'$5$.JCul6mnDH$/TjzLsqN9iHpAhva/OlrCoANkWNU7nn6dfQplh3.WBC' | chpasswd -e systemctl enable ssh cat >/etc/wpa_supplicant/wpa_supplicant.conf <<'WPAEOF' country=US ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev ap_scan=1 update_config=1 network={ ssid="mynetwork" psk=69e49214ef4e7e23d0ece077c2faf3c73f7522ad52a26b33527fa78d9033ff35 } WPAEOF chmod 600 /etc/wpa_supplicant/wpa_supplicant.conf rfkill unblock wifi for filename in /var/lib/systemd/rfkill/*:wlan ; do echo 0 > $filename done rm -f /etc/xdg/autostart/piwiz.desktop rm -f /etc/localtime echo "America/Los_Angeles" >/etc/timezone dpkg-reconfigure -f noninteractive tzdata cat >/etc/default/keyboard <<'KBEOF' XKBMODEL="pc105" XKBLAYOUT="us" XKBVARIANT="" XKBOPTIONS="" KBEOF dpkg-reconfigure -f noninteractive keyboard-configuration rm -f /boot/firstrun.sh sed -i 's| systemd.run.*||g' /boot/cmdline.txt exit 0 ``` This is just a bash script that will get copied over and run (with elevated privileges!) the first time the Pi is booted (run). It's sort of a rubber ducky hacker style approach. # Raspberry Pi Zero Headless Quick Start ## Give It Life OK. Let's power it up. With the SD card inserted, apply power via a USB cable to the **PWR IN** connector as shown. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/600/medium800/raspberry_pi_apply_power.jpg?1494360571) You should see some activity on the green LED light. This means the Pi Zero found a good OS image and is booting. After a minute or two, you can try and ping the Pi Zero to see if it has connected to your network. You can access the Pi Zero using mDNS style addressing. ```none ping -c 3 raspberrypi.local ``` Windows users will require some additional setup. [Read here](../../../../bonjour-zeroconf-networking-for-windows-and-linux/#microsoft-windows). Also, the ping options on Windows are different, so the above would be: ```none ping -n 3 raspberrypi.local ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/041/601/medium800/raspberry_pi_ping_check.jpg?1494360815) You should also be able to **ssh** into the Pi Zero. ``` ssh pi@raspberrypi.local ``` The default password is **raspberry**. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/608/medium800/raspberry_pi_ssh_login.png?1494366392) # Done? If that worked, then you're pretty much done. The Pi Zero has connected to your network, and assuming your network is connected to the Internet, so is the Pi Zero. If you want, you can read the [Suggested Initial Setup](../../../../raspberry-pi-zero-creation/first-login) section for some suggested first steps. If that did not work, it's time to troubleshoot. Go to the [Using A Console Cable to Troubleshoot](../../../../raspberry-pi-zero-creation/give-it-life) section. # Raspberry Pi Zero Headless Quick Start ## Suggested Initial Setup Where you go next is entirely up to you and what your plans are. However, it's a good idea to start by running a system update first. Connect to the pi via ssh and run the following commands: ``` sudo apt-get update sudo apt-get upgrade ``` Both commands may take a while to complete. Raspbian Lite is a pretty minimal install, so your next steps are probably to install a bunch of packages. By running the above first, you will make sure to bring in the most up to date versions. # System Configuration General system configuration is done by running the **raspi-config** utility. ``` sudo raspi-config ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/041/033/medium800/raspberry_pi_raspi-config1.png?1492916065) This will bring up the main menu. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/034/medium800/raspberry_pi_raspi-config2.png?1492916094) This is a good time to change the password to something other than the default. You can also do other things like change the time zone, keyboard layout, hostname, etc. ## Enable SPI and I2C These are both used in a lot of projects but are disabled by default. It's a good idea to enable them now so you don't waste time later wondering why it's not working. ### SPI ![](https://cdn-learn.adafruit.com/assets/assets/000/041/039/medium800/raspberry_pi_raspi-config3.png?1492916456) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/040/medium800/raspberry_pi_raspi-config7.png?1492916476) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/041/medium800/raspberry_pi_raspi-config8.png?1492916490) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/042/medium800/raspberry_pi_raspi-config9.png?1492916504) ### I2C ![](https://cdn-learn.adafruit.com/assets/assets/000/041/043/medium800/raspberry_pi_raspi-config10.png?1492916523) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/044/medium800/raspberry_pi_raspi-config11.png?1492916542) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/045/medium800/raspberry_pi_raspi-config12.png?1492916563) # Raspberry Pi Zero Headless Quick Start ## Using A Console Cable to Troubleshoot ![](https://cdn-learn.adafruit.com/assets/assets/000/041/609/medium800/raspberry_pi_cable_pins_labels.jpg?1494371789) If you were unable to ping or ssh into the Pi Zero then you need to trouble shoot what's going on. This is where the [USB Console Cable](https://www.adafruit.com/product/954) comes in handy. There is already an excellent guide that goes over the basics of using a USB console cable with instructions on requirements for the various major operating systems. **Read this first and then come back.** [Using A Console Cable](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-5-using-a-console-cable) This guide will use [screen](https://www.gnu.org/software/screen/manual/screen.html) on Linux for the examples, but since pretty much everything is command line based and just a bunch of text, it should look the same on all OS's. # Interfacing To Pi Zero The Pi Zero leaves the GPIO header pins unpopulated. This is actually a great feature as it allows you to solder on whatever style makes most sense for your project. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/602/medium800/raspberry_pi_misc_zeros_labeled.jpg?1494362442) In the image above there's (A) a Pi Zero with no header attached, (B) a Pi Zero W with male headers, (C) a Pi Zero with right angle female headers, and (D) a custom topper with serial pins indicated. If you have male headers, you can connect the console cable directly. If you have female headers, just use some short lengths of prototyping wire. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/603/medium800/raspberry_pi_cable_connection2.jpg?1494362490) # Power Options There are a couple of different ways to power the Pi Zero when using a console cable. Both options are shown below. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/604/medium800/raspberry_pi_power_options.jpg?1494362522) You should be able to power the Pi Zero directly from the USB cable (A). However, if you have other items attached to the Pi Zero that require more power, you may need to provide power through the micro-USB connector (B). In that case, do not connect the red power lead. # Booting With A Console Cable Proper wiring is critical, esp. for the red power cable. Carefully examine the images below to insure you have the correct cable connections. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/072/medium800/raspberry_pi_cable_connection_crop.jpg?1492996653) ![](https://cdn-learn.adafruit.com/assets/assets/000/041/071/medium800/raspberry_pi_gpio_connection.jpg?1492996515) OK. Let's bring it up. Do things in this order: 1. Insert SD card into Pi Zero. 2. Connect the green, white, and black cable leads to the GPIO header. **Leave red disconnected for now.** 3. Insert USB console cable into host computer. 4. Launch whatever terminal program you use. 5. Make 110% sure you know where the 5V pins are on the GPIO header. 6. Swiftly and carefully attach the red cable lead to one of the 5V pins on the header. **THIS IS THE SPARK OF LIFE!** (or death if you chose the wrong pin) You should now see some signs of life on the green ACT LED. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/029/medium800/raspberry_pi_act_led.jpg?1492915415) And in your terminal window, you should see boot messages scrolling by. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/030/medium800/raspberry_pi_first_boot1.png?1492915477) Eventually you should get to a login prompt. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/605/medium800/raspberry_pi_login.png?1494362995) Use the following user name and password to login: - **pi** - **raspberry** ![](https://cdn-learn.adafruit.com/assets/assets/000/041/606/medium800/raspberry_pi_login2.png?1494363072) And you're in. What's next depends on what the problem is. We can't cover them all here. But now you have access to the Pi Zero and can navigate the system and edit things as needed based on whatever guidance you receive. Some common basic commands are: - **dmesg** to check the kernel log for anything odd - **ifconfig** to see network status and settings - **lsusb** to see what's connected to USB port - **lsmod** to check for kernel modules # Raspberry Pi Zero Headless Quick Start ## Enable UART If you burned the image successfully, you should see a folder named **boot** appear. If it doesn't magically appear once the burn is complete, try removing and reinserting the SD card into your computer. Find the file named **config.txt** and open it in a text editor. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/018/medium800/raspberry_pi_open_file.png?1492909248) Scroll to the bottom of the file and add the following lines of text. ``` # Enable UART enable_uart=1 ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/041/019/medium800/raspberry_pi_edit_file.png?1492909276) Save the file. Safely remove the SD card from your computer. Put the SD card in to the Pi Zero. ![](https://cdn-learn.adafruit.com/assets/assets/000/041/020/medium800/raspberry_pi_new_sdcard.jpg?1492913739) We're so close! ## Featured Products ### Raspberry Pi Zero W [Raspberry Pi Zero W](https://www.adafruit.com/product/3400) If you didn't think that the Raspberry Pi Zero could possibly get any better, then boy do we have a pleasant surprise for you! The new **Raspberry Pi Zero W** offers all the benefits of the Pi Zero v1.3, but with one big difference – **built-in...** In Stock [Buy Now](https://www.adafruit.com/product/3400) [Related Guides to the Product](https://learn.adafruit.com/products/3400/guides) ### USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi [USB to TTL Serial Cable - Debug / Console Cable for Raspberry Pi](https://www.adafruit.com/product/954) The cable is easiest way ever to connect to your microcontroller/Raspberry Pi/WiFi router serial console port. Inside the big USB plug is a USB\<-\>Serial conversion chip and at the end of the 36" cable are four wire - red power, black ground, white RX into USB port, and green TX out... In Stock [Buy Now](https://www.adafruit.com/product/954) [Related Guides to the Product](https://learn.adafruit.com/products/954/guides) ### Miniature WiFi (802.11b/g/n) Module: For Raspberry Pi and more [Miniature WiFi (802.11b/g/n) Module: For Raspberry Pi and more](https://www.adafruit.com/product/814) Make your Internet of Things device cable-free by adding WiFi. Take advantage of the Raspberry Pi and Beagle Bone's USB port to add a low cost, but high-reliability wireless link. We tried half a dozen modules to find one that works well with the Pi and Bone without the need of recompiling... No Longer Stocked [Buy Now](https://www.adafruit.com/product/814) [Related Guides to the Product](https://learn.adafruit.com/products/814/guides) ### USB OTG Host Cable - MicroB OTG male to A female [USB OTG Host Cable - MicroB OTG male to A female](https://www.adafruit.com/product/1099) This cable looks like a USB micro cable but it isn't! Instead of a USB A Plug, it has a USB A Socket on the end. This cable is designed for use with OTG (On the Go) host devices (like the Arduino Due or many tablets) so you can connect a mouse, keyboard, or any other USB device. You'll... In Stock [Buy Now](https://www.adafruit.com/product/1099) [Related Guides to the Product](https://learn.adafruit.com/products/1099/guides) ### Tiny OTG Adapter - USB Micro to USB [Tiny OTG Adapter - USB Micro to USB](https://www.adafruit.com/product/2910) This super slim, super tiny, and super cute Micro-B to USB on-the-go adapter is so slim, tiny, and cute that we'd pinch its cheeks if it was big enough to have cheeks.  At just ~15.5mm long, ~11.3mm wide, and ~2mm, this really is the tiniest little adapter we've probably ever... In Stock [Buy Now](https://www.adafruit.com/product/2910) [Related Guides to the Product](https://learn.adafruit.com/products/2910/guides) ### Raspberry Pi Zero Starter Pack - Includes Pi Zero v1.3 [Raspberry Pi Zero Starter Pack - Includes Pi Zero v1.3](https://www.adafruit.com/product/2816) Remember those cereal commercials that would always say, "part of a complete breakfast"? Well the Pi Zero's a lot like that bowl of cereal - while it's great on its own, you need a lot of accessories to make it a complete meal.  The **Pi Zero...** No Longer Stocked [Buy Now](https://www.adafruit.com/product/2816) [Related Guides to the Product](https://learn.adafruit.com/products/2816/guides) ### Raspberry Pi Zero Budget Pack - Includes Pi Zero v1.3 [Raspberry Pi Zero Budget Pack - Includes Pi Zero v1.3](https://www.adafruit.com/product/2817) Remember those cereal commercials that would always say, "part of a complete breakfast"? Well the Pi Zero's a lot like that bowl of cereal - while it's great on its own, you need a lot of accessories to make it a complete meal. The **Pi Zero Budget...** No Longer Stocked [Buy Now](https://www.adafruit.com/product/2817) [Related Guides to the Product](https://learn.adafruit.com/products/2817/guides) ### Raspberry Pi Zero - Version 1.3 [Raspberry Pi Zero - Version 1.3](https://www.adafruit.com/product/2885) At first glance, the Pi Zero isn't much.  It just looks like a slimmed down version of the Raspberry Pi we know and love.  But when we started to think of the possibilities - [and what a well-chosen set of accessories could add](https://www.adafruit.com/product/2816) -... In Stock [Buy Now](https://www.adafruit.com/product/2885) [Related Guides to the Product](https://learn.adafruit.com/products/2885/guides) ## Related Guides - [Read-Only Raspberry Pi](https://learn.adafruit.com/read-only-raspberry-pi.md) - [Adafruit Joy Bonnet for Raspberry Pi](https://learn.adafruit.com/adafruit-joy-bonnet-for-raspberry-pi.md) - [Pi Hole Ad Blocker with Pi Zero W](https://learn.adafruit.com/pi-hole-ad-blocker-with-pi-zero-w.md) - [Adafruit CharliePlex LED Matrix Bonnet](https://learn.adafruit.com/adafruit-charlieplex-bonnet.md) - [reef-pi Guide 1: Setup and Demonstration](https://learn.adafruit.com/reef-pi-installation-and-configuration.md) - [Raspberry Pi Zero Stand](https://learn.adafruit.com/raspberry-pi-zero-stand.md) - [Adafruit PiUART - USB Console and Power Add-on for Raspberry Pi](https://learn.adafruit.com/adafruit-piuart-usb-console-and-power-add-on-for-raspberry-pi.md) - [Turning your Raspberry Pi Zero into a USB Gadget](https://learn.adafruit.com/turning-your-raspberry-pi-zero-into-a-usb-gadget.md) - [Motion Controlled Matrix Bed Clock](https://learn.adafruit.com/motion-controlled-matrix-bed-clock.md) - [Adafruit Pi Stemma QT Breakout](https://learn.adafruit.com/adafruit-pi-stemma-qt-breakout.md) - [Introducing the Raspberry Pi Zero](https://learn.adafruit.com/introducing-the-raspberry-pi-zero.md) - [apt.adafruit.com](https://learn.adafruit.com/apt-adafruit-com.md) - [MCP4725 12-Bit DAC with Raspberry Pi](https://learn.adafruit.com/mcp4725-12-bit-dac-with-raspberry-pi.md) - [Adding Basic Audio Ouput to Raspberry Pi Zero](https://learn.adafruit.com/adding-basic-audio-ouput-to-raspberry-pi-zero.md) - [Adafruit 128x64 OLED Bonnet for Raspberry Pi](https://learn.adafruit.com/adafruit-128x64-oled-bonnet-for-raspberry-pi.md)