<commit_before># raspberrypi-ua-netinst [![Issue Count](https://codeclimate.com/github/FooDeas/raspberrypi-ua-netinst/badges/issue_count.svg)](https://codeclimate.com/github/FooDeas/raspberrypi-ua-netinst)

- [Intro](#intro)
- [Requirements](#requirements)
- [Install instructions](#install-instructions)
- [Writing the installer to the SD card](#writing-the-installer-to-the-sd-card)
- [Installing](#installing)
- [Installer customization](#installer-customization)
- [First boot](#first-boot)
- [Logging](#logging)
- [Reinstalling or replacing an existing system](#reinstalling-or-replacing-an-existing-system)
- [Disclaimer](#disclaimer)

## Intro

The minimal Raspbian unattended netinstaller for Raspberry Pi.  

This initially was a fork of [raspbian-ua-netinst](https://github.com/debian-pi/raspbian-ua-netinst). Because of extensive changes and improvements it became independent.  
Some of the main differences are:

- improved performance out of the box
- full featured kernel and bootloader from raspberrypi.org (compatible with apt)
- more installer customization options
- ability to install via onboard wireless lan
- better compatibility with accessory

This project gives [Raspbian][1] power users the ability to install a minimal base system unattended using the latest Raspbian packages, regardless when the installer was built.

The installer with the default settings configures eth0 with DHCP to get internet connectivity and completely wipes the SD card from any previous installation.

### Features

- completely unattended, you only need a working internet connection through the ethernet port or use the onboard wireless LAN (supported on model 3B and 0W)
- DHCP and static IP configuration (DHCP is the default)
- always installs the latest version of Raspbian
- configurable default settings
- extra configuration over HTTP possible - gives unlimited flexibility
- installation takes about **20 minutes** with fast internet from power on to sshd running
- can fit on a 512MB SD card, but 1GB is more reasonable
- default installation includes `fake-hwclock` to save the current time at shutdown
- default installation includes NTP to keep time
- `/tmp` is mounted as tmpfs to improve speed
- no clutter included, you only get the bare essential packages
- option to install root to a USB drive

## Requirements

- a Raspberry Pi (from model 1B up to 3B or Zero including Zero W)
- SD card with at least 1GB, or at least 128MB for USB root install (without customization)
- ethernet or wireless LAN with a working internet connection

## Install instructions

1. Write the installer to the SD card
1. Provide unattended installation settings (optional) or follow the first boot steps later
1. Power on the Raspberry Pi and wait until the installation is done

## Writing the installer to the SD card

The installer archive contains all firmware files and the installer.

Go to [our latest release page](https://github.com/FooDeas/raspberrypi-ua-netinst/releases/latest) and download the .zip file.

Format your SD card as **FAT32** (MS-DOS on _Mac OS X_) and extract the installer files.

**Note:** If you get an error saying it can't mount `/dev/mmcblk0p1` on `/boot` then the most likely cause is that you're using exFAT instead of FAT32. Try formatting the SD card with [this tool](https://www.sdcard.org/downloads/formatter_4/).  
Further methods are described in [doc/INSTALL_ADVANCED.md](/doc/INSTALL_ADVANCED.md).

## Installing

Under normal circumstances, you can just power on your Pi and cross your fingers.
<commit_msg>doc: Add 3B+ models to README (#148)<commit_after># raspberrypi-ua-netinst [![Issue Count](https://codeclimate.com/github/FooDeas/raspberrypi-ua-netinst/badges/issue_count.svg)](https://codeclimate.com/github/FooDeas/raspberrypi-ua-netinst)

- [Intro](#intro)
- [Requirements](#requirements)
- [Install instructions](#install-instructions)
- [Writing the installer to the SD card](#writing-the-installer-to-the-sd-card)
- [Installing](#installing)
- [Installer customization](#installer-customization)
- [First boot](#first-boot)
- [Logging](#logging)
- [Reinstalling or replacing an existing system](#reinstalling-or-replacing-an-existing-system)
- [Disclaimer](#disclaimer)

## Intro

The minimal Raspbian unattended netinstaller for Raspberry Pi.  

This initially was a fork of [raspbian-ua-netinst](https://github.com/debian-pi/raspbian-ua-netinst). Because of extensive changes and improvements it became independent.  
Some of the main differences are:

- improved performance out of the box
- full featured kernel and bootloader from raspberrypi.org (compatible with apt)
- more installer customization options
- ability to install via onboard wireless lan
- better compatibility with accessory

This project gives [Raspbian][1] power users the ability to install a minimal base system unattended using the latest Raspbian packages, regardless when the installer was built.

The installer with the default settings configures eth0 with DHCP to get internet connectivity and completely wipes the SD card from any previous installation.

### Features

- completely unattended, you only need a working internet connection through the ethernet port or use the onboard wireless LAN (supported on model 3B, 3B+ and 0W)
- DHCP and static IP configuration (DHCP is the default)
- always installs the latest version of Raspbian
- configurable default settings
- extra configuration over HTTP possible - gives unlimited flexibility
- installation takes about **20 minutes** with fast internet from power on to sshd running
- can fit on a 512MB SD card, but 1GB is more reasonable
- default installation includes `fake-hwclock` to save the current time at shutdown
- default installation includes NTP to keep time
- `/tmp` is mounted as tmpfs to improve speed
- no clutter included, you only get the bare essential packages
- option to install root to a USB drive

## Requirements

- a Raspberry Pi (from model 1B up to 3B, 3B+ or Zero including Zero W)
- SD card with at least 1GB, or at least 128MB for USB root install (without customization)
- ethernet or wireless LAN with a working internet connection

## Install instructions

1. Write the installer to the SD card
1. Provide unattended installation settings (optional) or follow the first boot steps later
1. Power on the Raspberry Pi and wait until the installation is done

## Writing the installer to the SD card

The installer archive contains all firmware files and the installer.

Go to [our latest release page](https://github.com/FooDeas/raspberrypi-ua-netinst/releases/latest) and download the .zip file.

Format your SD card as **FAT32** (MS-DOS on _Mac OS X_) and extract the installer files.

**Note:** If you get an error saying it can't mount `/dev/mmcblk0p1` on `/boot` then the most likely cause is that you're using exFAT instead of FAT32. Try formatting the SD card with [this tool](https://www.sdcard.org/downloads/formatter_4/).  
Further methods are described in [doc/INSTALL_ADVANCED.md](/doc/INSTALL_ADVANCED.md).

## Installing

Under normal circumstances, you can just power on your Pi and cross your fingers.

{'fraction_non_alphanumeric': 0.07541625857002938, 'fraction_numerical': 0.008115293129984609, 'mean_word_length': 4.713828936850519, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 10, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '35270', 'n_tokens_mistral': 2053, 'n_tokens_neox': 1875, 'n_words': 884}