6.7 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!
1. Download the image (v1.1.0)
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 2 (Recommended)
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.
Checksum
10557f21beacbceaee172bd20e420e3e
Please note that the image is compressed, (on Linux/OSX) open your terminal and use the "7zip" command to decompress.
OSX
7za x kerberos-io-armv7-4GB-..
Linux
7z e from/kerberos-io-armv7-4GB-..
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.
Checksum
2b67a4ca6af0cdde39f4a428047da607
Please note that the image is compressed, (on Linux/OSX) open your terminal and use the "7zip" command to decompress.
OSX
7za x kerberos-io-armv6-4GB-..
Linux
7z e from/kerberos-io-armv6-4GB-..
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: 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=~kerberos-io.img of=/dev/disk3
3. Linux: transfer image with terminal
Format SD card
Select SD card and delete all partitions with gparted
gparted
To format the SD card, enter the following command:
sudo mkdosfs -F 16 -v /dev/sdb -I
Transfer image to your SD card
In Terminal, enter the following command ensuring that you identify the correct destination disc.
sudo dd if="kerberos-io-armvx-4GB-vy.img" of=/dev/sdb bs=2M
4. (Optional) Setup WIFI connection
If you will be using Kerberos.io with a WIFI dongle, then check out the F.A.Q. page.
5. Power on the Raspberry Pi
When the installation is completed, you can plug the SD card into your Raspberry Pi, and that's all. From this point you need to figure out the IP address of your Raspberry Pi. If you found your IP address (dynamic or static), you can open your favorite browser and type in the IP address. This will open the Kerberos login page, which you can access with the username: root and password: root.
6. (Optional) Access the Raspberry Pi with SSH
To use Kerberos you only need access to the webinterface, however you can also access the system with SSH.
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.