Generate Turtle OS image
Switch branches/tags
Clone or download
bjsowa Merge pull request #15 from bjsowa/master
use xenial distribution in Travis CI
Latest commit baee112 Dec 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci machine again Aug 20, 2018
pi-gen @ 330ce73 add pi-gen Aug 17, 2018
pi-gen-overlay/stage3 add build info to motd Oct 12, 2018
.gitignore add EDIT file to gitignore Oct 6, 2018
.gitmodules change url in gitmodules Aug 17, 2018
.travis.yml use xenial distribution in Travis CI Dec 8, 2018
LICENSE Update LICENSE Aug 16, 2018 fix #9 Nov 28, 2018 use github token Oct 8, 2018

Turtle Rover

Turtle OS

Modified Raspbian Lite

Build Status Release

Website | Facebook | YouTube

How to install

Installation procedure is the same as for original Raspbian image which is described here.

How to connect via SSH

SSH using Linux or Mac OS

You will need to know your Raspberry Pi's IP address to connect to it. If You're connecting using Turtle Acess Point Turtle-XXYYY the adress is static: You can also connect using Ethernet cable. In this case You have to set in IPv4 settings of Ethernet connection to Share with other computers on Your computer. Then, using e.g. arp, find address. It usually starts with 10.x.x.x and is dynamic.

To connect to your Pi from a different computer, copy and paste the following command into the terminal window but replace with the IP address of the Raspberry Pi. Use Ctrl + Shift + V to paste in the terminal.

ssh pi@<IP>

If you receive a connection timed out error it is likely that you have entered the wrong IP address for the Raspberry Pi.

When the connection works you will see a security/authenticity warning. Type yes to continue. You will only see this warning the first time you connect.

In the event your Pi has taken the IP address of a device to which your computer has connected before (even if this was on another network), you may be given a warning and asked to clear the record from your list of known devices. Following this instruction and trying the ssh command again should be successful.

Next you will be prompted for the password. We are using identical login: pi and password: raspberry, as official Raspbian.


SSH using Windows

For Windows You can follow this official steps. If You're connecting using Turtle Acess Point Turtle-XXYYY the adress is static: We are using identical login: pi and password: raspberry, as official Raspbian.

How to configure

  • To change HotSpot name (SSID), passphrase, channel, etc. change /etc/hostapd/hostapd.conf file. e.g. using nano sudo nano /etc/hostapd/hostapd.conf
  • Works best with RT5370 WiFi adapter, or any that uses rt2800usb driver

Modifications in this image

Boot tweaks

  • Patch cmdline.txt: disable repair, disable serial0
  • Patch config.txt: enable uart, disable splash
  • Add ssh file by default
  • Turtle Rover configs

System tweaks

  • Patch sshd to disallow client to pass locale environment variables
  • Add custom hostapd.service
  • Add turtle.service
  • Install hostapd
  • Install uv4l and custom config

Network tweaks

  • Patch hosts
  • Add systemd network files
    • External wifi interface (hotspot) wlan0ext, ip:, default SSID: TurtleRover-XXYYY, password: password
    • Internal wifi interface wlan0int
  • Add custom wpa_supplicant-wlan0int.conf
  • Add custom dnsmasq.conf
  • Add custom resolvconf.conf
  • Add custom sysctl.conf
  • Install dnsmasq

Custom software

How it works

  1. We are removing original stage3, stage4, stage5
  2. Copying our stage3 which provides all needed changes to run Turtle Rover
  3. Build image

How to generate Turtle OS

  • To download files from Github with no limit you need Github token, place GITHUB_TOKEN file with content GITHUB_TOKEN=... in project root
  • Build all stages sudo ./
  • Build only stage3 sudo ./ -s

How to add and edit patches

Strongly inspired by 🤡 BigClown Raspbian 🤡