2017-07-03 09:59:39 -04:00
|
|
|
barnacleos/build
|
2017-06-30 17:32:33 -04:00
|
|
|
================
|
2017-05-06 19:16:00 -04:00
|
|
|
|
2017-07-02 02:52:40 -04:00
|
|
|
Tool used to create the [BarnacleOS](https://github.com/barnacleos) images.
|
2017-07-02 02:51:25 -04:00
|
|
|
Based on [pi-gen](https://github.com/rpi-distro/pi-gen) tool used to create
|
2017-07-02 11:12:22 -04:00
|
|
|
the official [raspberrypi.org](https://raspberrypi.org) Raspbian images.
|
2017-05-06 19:16:00 -04:00
|
|
|
|
|
|
|
|
|
2017-06-30 17:36:04 -04:00
|
|
|
|
2017-07-09 12:53:10 -04:00
|
|
|
Table of contents
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
* [Dependencies](#dependencies)
|
2017-07-09 12:59:16 -04:00
|
|
|
* [Build](#build)
|
2017-07-09 12:53:10 -04:00
|
|
|
* [Network interfaces](#network-interfaces)
|
|
|
|
|
* [System configuration](#system-configuration)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-06-30 17:36:04 -04:00
|
|
|
Dependencies
|
|
|
|
|
------------
|
2016-04-11 02:25:30 -04:00
|
|
|
|
2017-05-06 19:16:00 -04:00
|
|
|
On Debian-based systems:
|
|
|
|
|
|
|
|
|
|
```bash
|
2017-07-07 12:42:48 -04:00
|
|
|
apt-get install bash quilt parted qemu-user-static debootstrap zerofree zip \
|
2017-07-03 03:13:19 -04:00
|
|
|
dosfstools libcap2-bin grep rsync
|
2017-05-06 19:16:00 -04:00
|
|
|
```
|
|
|
|
|
|
2017-07-02 00:19:03 -04:00
|
|
|
The file `depends` contains a list of tools needed. The format of this
|
2017-07-02 02:55:42 -04:00
|
|
|
file is `<tool>[:<debian-package>]`.
|
2017-07-06 18:03:27 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-07-09 12:59:16 -04:00
|
|
|
Build
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
Run `sudo ./build.sh` to build the image. The following files will be created:
|
|
|
|
|
|
|
|
|
|
* `rootfs/` - the root file system (`/` and `/boot/` partitions)
|
2017-07-09 20:52:51 -04:00
|
|
|
* `deploy/BarnacleOS-YYYY-MM-DD.img` - the image to write to SD card
|
|
|
|
|
* `deploy/BarnacleOS-YYYY-MM-DD.zip` - ZIP archive with the image
|
2017-07-09 12:59:16 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-07-09 12:27:50 -04:00
|
|
|
Network interfaces
|
|
|
|
|
------------------
|
|
|
|
|
|
2017-09-17 04:42:32 -04:00
|
|
|
Some initial configuration may be required to use the default BarnacleOS
|
2017-07-09 12:27:50 -04:00
|
|
|
image, such as Wi-Fi drivers installation. It can be done via SSH. Network
|
2017-09-13 17:12:52 -04:00
|
|
|
interface `eth0` has default configurations to help you to connect.
|
|
|
|
|
It is configured by default to get IPv4 address from router via DHCP
|
2017-07-09 12:27:50 -04:00
|
|
|
without any assumptions about subnet configuration. You can just plug
|
|
|
|
|
your Raspberry Pi to router with Ethernet cable, discover which address
|
|
|
|
|
was given to it in router's web interface or with `nmap` utility and connect
|
|
|
|
|
to it via SSH.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-07-06 19:38:56 -04:00
|
|
|
System configuration
|
|
|
|
|
--------------------
|
|
|
|
|
|
2017-07-09 12:35:09 -04:00
|
|
|
The following information can be helpful when you connect to BarnacleOS router
|
|
|
|
|
and configure it:
|
|
|
|
|
|
2017-07-06 19:38:56 -04:00
|
|
|
* Root login via SSH is disabled
|
2017-07-07 12:29:43 -04:00
|
|
|
* Root password is disabled
|
2017-07-06 19:38:56 -04:00
|
|
|
* User `user` has access via SSH with password `password`
|
|
|
|
|
* SSH host keys are generated at first startup,
|
|
|
|
|
so fingerprint is different for each installation of the same image
|
|
|
|
|
* User has passwordless sudo
|
