Getting Started with ThinStation

Thinstation edited this page Jul 5, 2018 · 13 revisions

Cloning the ThinStation Git repository

You need a reasonably modern Linux installation with [Git][] installed. [Git]: https://git-scm.com/

Start up a shell window and run:

git clone --depth 1 git://github.com/Thinstation/thinstation.git -b 6.1-Stable

This will clone the current stable ThinStation branch into a newly created directory thinstation.

Building a boot image

Enter the chroot building environment:

cd thinstation
./setup-chroot

This will take a few seconds. You will end up reading the file README.md. Leave the pager application by pressing q.

Let’s move on with building your first ThinStation boot image:

cd build
./build

This will again take some time (up to a few minutes, depending on your system). In the subdirectory boot-images three flavours of boot images get created. You could now go and boot either of these images, but they probably will be of no real use to you, because the standard configuration is very generic. Most people getting into ThinStation usually need a very specific result, so we really need to edit the configs to make something useful.

If necessary you can use the --kernel option of the build script to choose a certain Linux kernel.

What’s next?

After having seen how to build ThinStation boot images, it is time for you to adapt the configuration to your requirements. This involves

  • deciding how to deploy ThinStation (how to boot up your thin clients),
  • analysing the target hardware (where your boot image is intended to be run on),
  • choosing the applications (or protocols) to be used by the end user and
  • for each application defining the parameters (details on how it should operate). See here for further instructions.

From time to time you will want to update your repository.