Getting Started

Topics:

• Prerequisites
• Preparing Your Repo
• Synchronizing thingOS Changes
• Customization
• Building
• Installing
• First Boot

---

Prerequisites

Before hitting the road, make sure that:

• you have significant experience with Linux
• you're familiar with building software from source
• you have a computer running a recent Linux distro
• you have a supported single board computer with an SD card at your disposal
• you know what BuildRoot is about and you have read (at least briefly) their user manual
• your Linux system meets BuildRoot's requirements

Preparing Your Repo

With thingOS the workflow is a bit different than what you're probably expecting. In order to develop your OS, you're supposed to fork the thingOS repo and do your work on your own repo, unless, of course, you want to contribute directly to the thingOS project.

Start by creating your own empty git repo, called mythingos:

mkdir mythingos && cd mythingos && git init

Then add thingOS as a git remote and fetch it:

git remote add thingos https://github.com/ccrisan/thingos.git
git fetch thingos

Now create a branch called thingos to track the thingOS master branch:

git branch --track thingos thingos/master

Finally, switch to your master branch, which is identical to thingos/master, for now:

git checkout master

Synchronizing thingOS Changes

Everytime you want to pull in changes from thingOS, you'll need to update the thingOS branch:

git checkout thingos && git pull

Then you need to merge the changes into your master (or whatever branch you use):

git checkout master
git merge thingos

Customization

Building

Installing

First Boot