mirror of
https://github.com/kerberos-io/documentation.git
synced 2026-08-23 15:18:31 +00:00
show installer on kios page
This commit is contained in:
Cédric Verstraeten
@@ -12,132 +12,247 @@
|
||||
|
||||
To install KiOS you can <b>use our own installer</b>, which gives you a nice GUI that will handle the flashing for you, <b>or you can do the flashing yourself</b>.
|
||||
|
||||
<button id="installer-btn" class="btn" style="width: 49%; height: 50px; background-color: #943633; font-size: 16px; color: #fff; outline: 0;">Easy installation</button>
|
||||
<button id="advanced-btn" class="btn" style="width: 49%; height: 50px; background-color: #ddd; font-size: 16px; color: #fff; outline: 0;">Advanced installation</button>
|
||||
|
||||
<div id="installer">
|
||||
|
||||
<h2>Installer</h2>
|
||||
By using the KiOS installer, you'll get <b>an easy to use GUI</b> which allows you to configure and flash KiOS to your SD card. Just download the installer, select a version, specify your network configurations, select your SD card and press the flash button; it can't be easier.
|
||||
<h2>Easy Installation</h2>
|
||||
|
||||
By using the KiOS installer, you'll get <b>an easy to use GUI</b> which allows you to configure and flash KiOS to your SD card. Just download the installer, select a version, specify your network configurations, select your SD card and press the flash button; it can't be easier.
|
||||
|
||||
<div id="installation-wrapper" style="display: block; margin-top: 20px; position: relative;">
|
||||
<div id="kios-installation" class="kios-installation" style="background:url('/images/kios-install.gif') no-repeat; width: 100%; height: 285px; background-size: cover; display: table; margin: 0 auto; border-radius: 10px; z-index: 10; position: relative;">
|
||||
|
||||
</div>
|
||||
<div id="bottom-download" class="btn-group" style="display: none; z-index: 99; top: -150px; margin-top: -49px; position: relative;">
|
||||
<a class="current-version btn btn-success btn-lg" style="border: 3px solid #fff; border-right: none;" data-track-id="jumbotron button" role="button"></a>
|
||||
<button type="button" class="btn btn-success btn-lg dropdown-toggle" style="border: 3px solid #fff; border-left: none;" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
|
||||
<span class="caret"></span>
|
||||
<span class="sr-only">Toggle Dropdown</span>
|
||||
</button>
|
||||
<ul class="dropdown-menu"></ul>
|
||||
</div>
|
||||
<script type="text/javascript">
|
||||
require([_jsBase + 'main.js'], function(common)
|
||||
{
|
||||
require(["jquery"], function($)
|
||||
{
|
||||
$(function()
|
||||
{
|
||||
$("#advanced-btn").click(function(){
|
||||
$("#installer-btn").css({"background-color":"#ddd"});
|
||||
$("#advanced-btn").css({"background-color":"#943633"});
|
||||
$("#installer").hide();
|
||||
$("#advanced").show();
|
||||
})
|
||||
|
||||
$("#installer-btn").click(function(){
|
||||
$("#installer-btn").css({"background-color":"#943633"});
|
||||
$("#advanced-btn").css({"background-color":"#ddd"});
|
||||
$("#advanced").hide();
|
||||
$("#installer").show();
|
||||
})
|
||||
|
||||
var platform = window.navigator.platform;
|
||||
var versions = [
|
||||
{
|
||||
|
||||
name: "KiOS for Mac",
|
||||
long_name: "Download Installer for OSX >= 10.9",
|
||||
href: "https://google.com",
|
||||
os: "MacIntel",
|
||||
},
|
||||
{
|
||||
name: "KiOS for for Linux (x86)",
|
||||
long_name: "Download Installer for Linux (32 bit)",
|
||||
href: "https://google.com",
|
||||
os: "Linux",
|
||||
},
|
||||
{
|
||||
name: "KiOS for for Linux (x64)",
|
||||
long_name: "Download Installer for Linux (64 bit)",
|
||||
href: "https://google.com",
|
||||
os: "Linux x86_64",
|
||||
},
|
||||
{
|
||||
name: "KiOS for Windows (x86)",
|
||||
long_name: "Download Installer for Windows (32 bit)",
|
||||
href: "https://google.com",
|
||||
os: "Linux i686",
|
||||
},
|
||||
{
|
||||
name: "KiOS for Windows (x64)",
|
||||
long_name: "Download Installer for Windows (64 bit)",
|
||||
href: "https://google.com",
|
||||
os: "Win16",
|
||||
}
|
||||
];
|
||||
|
||||
// Specify current version
|
||||
var currentVersion = $.grep(versions, function(el){
|
||||
return el.os == platform;
|
||||
});
|
||||
|
||||
if(currentVersion.length > 0)
|
||||
$(".current-version").html(currentVersion[0].long_name);
|
||||
$(".current-version").attr('href', currentVersion[0].href);
|
||||
|
||||
// Fill dropdowns
|
||||
var dropdown = $(".dropdown-menu");
|
||||
for(var i = 0; i < versions.length; i++)
|
||||
{
|
||||
dropdown.append('<li><a href="' + versions[i].href + '">' + versions[i].name + '</a></li>');
|
||||
}
|
||||
|
||||
$("#bottom-download").hide();
|
||||
var background = $("#kios-installation").css('background');
|
||||
|
||||
$("#installation-wrapper").bind("mouseenter", function ()
|
||||
{
|
||||
$("#kios-installation").css({
|
||||
'filter':'blur(3px)',
|
||||
'-webkit-filter':'blur(3px)',
|
||||
'-webkit-transition':'all 0.3s linear'
|
||||
})
|
||||
$("#bottom-download").fadeIn(300);
|
||||
|
||||
}).bind("mouseleave", function ()
|
||||
{
|
||||
$("#kios-installation").css({
|
||||
'filter':'blur(0)',
|
||||
'-webkit-filter':'blur(0)',
|
||||
'-webkit-transition':'all 0.3s linear'
|
||||
})
|
||||
|
||||
$("#bottom-download").fadeOut(300);
|
||||
});
|
||||
});
|
||||
});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="advanced" style="display: none;">
|
||||
|
||||
<div id="advanced">
|
||||
<h2>Advanced</h2>
|
||||
<h2>Advanced Installation</h2>
|
||||
|
||||
It's not a problem if you don't want to use the KiOS installer. You can download the KiOS .img yourself and flash it to your SD card.<br/><br/>
|
||||
It's not a problem if you don't want to use the KiOS installer. You can download the KiOS .img yourself and flash it to your SD card.<br/><br/>
|
||||
|
||||
<iframe src="https://player.vimeo.com/video/164054497?autoplay=0&color=943633" style="width:100%; height: 400px;" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
|
||||
<iframe src="https://player.vimeo.com/video/164054497?autoplay=0&color=943633" style="width:100%; height: 400px;" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
|
||||
|
||||
<a name="download"></a>
|
||||
<h2>1. Download the .img</h2>
|
||||
<a name="download"></a>
|
||||
<h2>1. Download the .img</h2>
|
||||
|
||||
All releases are stored on the KiOS <a href="https://github.com/kerberos-io/kios"><b>Github repository</b></a>, each release contains several images (for every Raspberry Pi version a different image is created). It's important to download the correct image; installing an image for another Raspberry Pi version will not work. After downloading, make sure to unzip the release.
|
||||
All releases are stored on the KiOS <a href="https://github.com/kerberos-io/kios"><b>Github repository</b></a>, each release contains several images (for every Raspberry Pi version a different image is created). It's important to download the correct image; installing an image for another Raspberry Pi version will not work. After downloading, make sure to unzip the release.
|
||||
|
||||
[](https://github.com/kerberos-io/kios/releases)
|
||||
[](https://github.com/kerberos-io/kios/releases)
|
||||
|
||||
<a name="flash"></a>
|
||||
<h2>2. Flash the .img to a SD card</h2>
|
||||
<a name="flash"></a>
|
||||
<h2>2. Flash the .img to a SD card</h2>
|
||||
|
||||
Ensure that you have inserted the SD card, that you wish to clone, into the SD card reader. If you dont have an internal SD card reader, you will need to plug in an external SD card reader via a USB socket.
|
||||
Ensure that you have inserted the SD card, that you wish to clone, into the SD card reader. If you dont have an internal SD card reader, you will need to plug in an external SD card reader via a USB socket.
|
||||
|
||||
<h3>OSX</h3>
|
||||
<h3>OSX</h3>
|
||||
|
||||
<ul>
|
||||
<li>Download and install <a href="https://mega.co.nz/#!PZc2HTTQ!eD9dtFpoKnbZqP1hkvrv43_Pvc9xadMVxRP2K-M8n88">RPi-sd card builder v1.2</a>.</li>
|
||||
<li>Run the app.</li>
|
||||
<li>Select the kios-x-y.img.</li>
|
||||
<li>Select your SD card.</li>
|
||||
<li>Insert your password, as the program will need administrator privileges.</li>
|
||||
<li>The system will start transferring the image to your SD card.</li>
|
||||
<li>A confirmation is shown that the transferred is completed and SD card unmounted.</li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li>Download and install <a href="https://mega.co.nz/#!PZc2HTTQ!eD9dtFpoKnbZqP1hkvrv43_Pvc9xadMVxRP2K-M8n88">RPi-sd card builder v1.2</a>.</li>
|
||||
<li>Run the app.</li>
|
||||
<li>Select the kios-x-y.img.</li>
|
||||
<li>Select your SD card.</li>
|
||||
<li>Insert your password, as the program will need administrator privileges.</li>
|
||||
<li>The system will start transferring the image to your SD card.</li>
|
||||
<li>A confirmation is shown that the transferred is completed and SD card unmounted.</li>
|
||||
</ul>
|
||||
|
||||
<h3>Windows</h3>
|
||||
<h3>Windows</h3>
|
||||
|
||||
<ul>
|
||||
<li>Download and install <a href="http://sourceforge.net/projects/win32diskimager/files/latest/download">Win32DiskImager</a>.</li>
|
||||
<li>Select the KiOS image and the drive letter of the SD card.</li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li>Download and install <a href="http://sourceforge.net/projects/win32diskimager/files/latest/download">Win32DiskImager</a>.</li>
|
||||
<li>Select the KiOS image and the drive letter of the SD card.</li>
|
||||
</ul>
|
||||
|
||||
<h3>Linux</h3>
|
||||
<h3>Linux</h3>
|
||||
|
||||
<h4>Format SD card</h4>
|
||||
<h4>Format SD card</h4>
|
||||
|
||||
Select SD card and delete all partitions with gparted
|
||||
Select SD card and delete all partitions with gparted
|
||||
|
||||
<pre><code>gparted
|
||||
</code></pre>
|
||||
<pre><code>gparted
|
||||
</code></pre>
|
||||
|
||||
To format the SD card, enter the following command:
|
||||
To format the SD card, enter the following command:
|
||||
|
||||
<pre><code>sudo mkdosfs -F 16 -v /dev/sdb -I
|
||||
</code></pre>
|
||||
<pre><code>sudo mkdosfs -F 16 -v /dev/sdb -I
|
||||
</code></pre>
|
||||
|
||||
<h4>Transfer image to your SD card</h4>
|
||||
<h4>Transfer image to your SD card</h4>
|
||||
|
||||
In Terminal, enter the following command ensuring that you identify the correct destination disc.
|
||||
In Terminal, enter the following command ensuring that you identify the correct destination disc.
|
||||
|
||||
<pre><code>sudo dd if="kios-x-y.img" of=/dev/sdb bs=2M
|
||||
</code></pre>
|
||||
<pre><code>sudo dd if="kios-x-y.img" of=/dev/sdb bs=2M
|
||||
</code></pre>
|
||||
|
||||
<a name="network"></a>
|
||||
<h2>3. Network configuration</h2>
|
||||
<a name="network"></a>
|
||||
<h2>3. Network configuration</h2>
|
||||
|
||||
After the image has been transferred, you can plug the SD card in to your Raspberry Pi and everything will work magically. By default the KiOS image will require an ethernet connection and use DHCP to give you a dynamic IP-address. However if you want to have a <b>static IP-address</b> or/and use a <b>wireless connection</b>, you'll need to do a small configuration. Insert the SD card into your working station and open the SD card, you'll see two files <b>static_ip.conf</b> and <b>wireless.conf</b>.
|
||||
After the image has been transferred, you can plug the SD card in to your Raspberry Pi and everything will work magically. By default the KiOS image will require an ethernet connection and use DHCP to give you a dynamic IP-address. However if you want to have a <b>static IP-address</b> or/and use a <b>wireless connection</b>, you'll need to do a small configuration. Insert the SD card into your working station and open the SD card, you'll see two files <b>static_ip.conf</b> and <b>wireless.conf</b>.
|
||||
|
||||
<h3>Static IP-address</h3>
|
||||
<h3>Static IP-address</h3>
|
||||
|
||||
Open and edit the file <b>static_ip.conf</b>.
|
||||
Open and edit the file <b>static_ip.conf</b>.
|
||||
|
||||
<pre><code>#####################################################################
|
||||
# Enter the IP-address you want to have, followed by the subnet mask
|
||||
# e.g. 192.168.0.10/24
|
||||
<pre><code>#####################################################################
|
||||
# Enter the IP-address you want to have, followed by the subnet mask
|
||||
# e.g. 192.168.0.10/24
|
||||
|
||||
static_ip=""
|
||||
static_ip=""
|
||||
|
||||
#####################################################################
|
||||
# Enter the Gateway and DNS, this will be your router in most cases
|
||||
# e.g. 192.168.0.1
|
||||
#####################################################################
|
||||
# Enter the Gateway and DNS, this will be your router in most cases
|
||||
# e.g. 192.168.0.1
|
||||
|
||||
static_gw=""
|
||||
static_dns=""
|
||||
</code></pre>
|
||||
static_gw=""
|
||||
static_dns=""
|
||||
</code></pre>
|
||||
|
||||
<h3>Wireless connection</h3>
|
||||
<h3>Wireless connection</h3>
|
||||
|
||||
Open and edit the file <b>wireless.conf</b>. Fill-in your WIFI credentials: <b>SSID</b> the name of your wireles network, and <b>PSK</b> the password of your wireless network.
|
||||
Open and edit the file <b>wireless.conf</b>. Fill-in your WIFI credentials: <b>SSID</b> the name of your wireles network, and <b>PSK</b> the password of your wireless network.
|
||||
|
||||
<pre><code>update_config=1
|
||||
ctrl_interface=/var/run/wpa_supplicant
|
||||
<pre><code>update_config=1
|
||||
ctrl_interface=/var/run/wpa_supplicant
|
||||
|
||||
network={
|
||||
scan_ssid=1
|
||||
ssid=""
|
||||
psk=""
|
||||
}
|
||||
</code></pre>
|
||||
network={
|
||||
scan_ssid=1
|
||||
ssid=""
|
||||
psk=""
|
||||
}
|
||||
</code></pre>
|
||||
|
||||
<a name="poweron"></a>
|
||||
<h2>4. Power on the Raspberry Pi</h2>
|
||||
<a name="poweron"></a>
|
||||
<h2>4. Power on the Raspberry Pi</h2>
|
||||
|
||||
When the installation is completed, you can <b>plug the SD card</b> into your Raspberry Pi. From this point KiOS will boot the kernel and re-partition your SD-card; Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can <b>open your favorite browser</b> and type in the IP address of your Raspberry Pi. This will open the Kerberos.io login page, which you can <b>access</b> with the username: <b>root</b> and password: <b>root</b>.
|
||||
When the installation is completed, you can <b>plug the SD card</b> into your Raspberry Pi. From this point KiOS will boot the kernel and re-partition your SD-card; Please note that the first time you boot KiOS it can take about 2 mins before the system is operational. When KiOS is ready you can <b>open your favorite browser</b> and type in the IP address of your Raspberry Pi. This will open the Kerberos.io login page, which you can <b>access</b> with the username: <b>root</b> and password: <b>root</b>.
|
||||
|
||||
|
||||
|
||||
|
||||
<a name="access"></a>
|
||||
<h2>5. Access the Raspberry Pi with SSH</h2>
|
||||
<a name="access"></a>
|
||||
<h2>5. Access the Raspberry Pi with SSH</h2>
|
||||
|
||||
To use Kerberos.io you only need access to the webinterface, however you can also <b>access the system with SSH</b>.
|
||||
To use Kerberos.io you only need access to the webinterface, however you can also <b>access the system with SSH</b>.
|
||||
|
||||
<pre><code>Cedrics-Mac-mini:build cedricverst$ ssh root@192.168.0.12
|
||||
Welcome to kios-79e30bbb!
|
||||
[root@kios-79e30bbb ~]#
|
||||
</code></pre>
|
||||
<pre><code>Cedrics-Mac-mini:build cedricverst$ ssh root@192.168.0.12
|
||||
Welcome to kios-79e30bbb!
|
||||
[root@kios-79e30bbb ~]#
|
||||
</code></pre>
|
||||
|
||||
Note that by default no root password is set, you can define a password in the <b>/data/etc/kios.conf</b> file.
|
||||
Note that by default no root password is set, you can define a password in the <b>/data/etc/kios.conf</b> file.
|
||||
|
||||
<pre><code>[root@kios-79e30bbb ~]# nano /data/etc/kios.conf
|
||||
[root@kios-79e30bbb ~]# reboot
|
||||
</code></pre>
|
||||
<pre><code>[root@kios-79e30bbb ~]# nano /data/etc/kios.conf
|
||||
[root@kios-79e30bbb ~]# reboot
|
||||
</code></pre>
|
||||
|
||||
Add your password, save the file and reboot the system.
|
||||
Add your password, save the file and reboot the system.
|
||||
</div>
|
||||
Reference in New Issue
Block a user