4.9 KiB
Installation
Kerberos is easy to install, you just have to copy the Kerberos image to your SD card, plug the SD card into your Raspberry Pi and that's it. It can also be installed on other devices than the Raspberry Pi; for development or production. Therefore you will need to compile the machinery from source and install the webinterface with your favorite webserver.
Install from image
If you want to use Kerberos.io as a service, this would be the preferred way. Kerberos is provided as an image, a pre-installed operating system. The only thing you have to do to make things work, is to transfer the image to your SD card. After transferring you can just plug the SD card into your Raspberry Pi and kerberos will work; isn't that great!
The're a lot of different ways to accomplish this, and they are different according the operating system you will be using to transfer the image.
1. Download the image
First you will need to download the Kerberos image; click on the image below. The Kerberos.io image contains a Linux operating system, built on Arch Linux. The image has the machinery and webinterface installed, and ofcourse all the dependencies Kerberos needs. With this image you just have to plugin the SD card in your Raspberry Pi and you're done.
Raspberry Pi Model A, A+, B and B+
The Raspberry Pi is a credit-card sized computer that plugs into your TV and a keyboard. It’s a capable little PC which can be used for many of the things that your desktop PC does, like spreadsheets, word-processing and games. It also plays high-definition video.
Raspberry Pi Model 2
The Raspberry Pi 2 is the successor to the Raspberry Pi. It builds upon the original model B+ upgrading to 1 GB of RAM, and replacing the aged ARMv6l single-core with an ARMv7l Cortex-A7 quad-core.
2. Insert your SD Card
Ensure that you have inserted the SD card, that you wish to clone, into the SD card reader. If your PC/Mac does'nt have an internal SD card reader, you will need to plug in an external SD card reader via a USB socket.
3. OSX: transfer image
- Download the .dmg file (RPi-sd card builder v1.2)
- Run the app
- Select the operating system distributions (.img file)
- You will prompt with this. After you connect your SD card press continue.
- Now you have to select your SD card.
- Now the program will need administrator privileges. insert your password
- Confirm that your SD card has been unmounted.
3. Windows: transfer image
- Download and install the Win32DiskImager.
- Select the image file you've downloaded earlier and the drive letter of the SD card.
3. OSX/Linux: transfer image with terminal
Locate Your SD Card
Open Terminal and enter the following command to locate your SD Card:
diskutil list
Look for your SD card; you can look at the size of the disk. In most cases you will be using a 4GB or bigger SD card.
Unmount SD card
We located our SD card at the /dev/disk3 drive; please note that this can be another disk drive, see previous step. In Terminal, enter the following command:
diskutil unmountDisk /dev/disk3
Format SD card
To format the SD card, enter the following command:
sudo newfs_msdos -F 16 /dev/disk3
Transfer image to your SD card
In Terminal, enter the following command ensuring that you identify the correct destination disc.
sudo dd if=~/Desktop/kerberos-io.img of=/dev/disk3
4. (Optional) Setup WIFI connection
If you will be using Kerberos.io with a WIFI dongle, then check out the F.A.Q. page.
Install from source
This will be the procedure if you want to contribute to Kerberos or if you want to use Kerberos on your local machine. To install Kerberos from source; you will need to compile the machinery from source and import the webinterface into your favorite webserver.