kerberos-io/documentation
1
0
Fork 0
mirror of https://github.com/kerberos-io/documentation.git synced 2026-08-23 15:18:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix formatting of advanced installation

Browse Source
This commit is contained in:
Cédric Verstraeten
2016-10-01 23:18:58 +02:00
parent b756f2c031
commit 030845c44d
1 changed files with 13 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
70_installation/2_KiOS.md
View File

@@ -91,21 +91,21 @@ You can install KiOS by using our **own installer**, which gives you a nice GUI
<div id="advanced" style="display: none;">
<h2>Advanced Installation</h2>
If you prefer **the hard way**, you can also flash **Kerberos.io** to your SD card manually. So it's not a problem if you don't want to use the KiOS installer. It goes as follows: download the KiOS .img yourself, flash it to your SD card with your terminal and edit some configuration files in the boot directory.<br/><br/>
<p>If you prefer <b>the hard way</b>, you can also flash **Kerberos.io** to your SD card manually. So it's not a problem if you don't want to use the KiOS installer. It goes as follows: download the KiOS .img yourself, flash it to your SD card with your terminal and edit some configuration files in the boot directory.</p>
<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>
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.
<p>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.</p>
<a href="https://github.com/kerberos-io/kios/releases"><img alt="Download KiOS" src="2_kerberos-image.png"/></a>
<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.
<p>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.</p>
<h3>OSX</h3>
@@ -130,28 +130,28 @@ You can install KiOS by using our **own installer**, which gives you a nice GUI
<h4>Format SD card</h4>
Select SD card and delete all partitions with gparted
<p>Select SD card and delete all partitions with gparted</p>
<pre><code>gparted</code></pre>
To format the SD card, enter the following command:
<p>To format the SD card, enter the following command:</p>
<pre><code>sudo mkdosfs -F 16 -v /dev/sdb -I</code></pre>
<h4>Transfer image to your SD card</h4>
In Terminal, enter the following command ensuring that you identify the correct destination disc.
<p>In Terminal, enter the following command ensuring that you identify the correct destination disc.</p>
<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>
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>.
<p>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>.</p>
<h3>Static IP-address</h3>
Open and edit the file <b>static_ip.conf</b>.
<p>Open and edit the file <b>static_ip.conf</b>.</p>
<pre><code>#####################################################################
# Enter the IP-address you want to have, followed by the subnet mask
@@ -168,7 +168,7 @@ static_dns=""</code></pre>
<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.
<p>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.</p>
<pre><code>update_config=1
ctrl_interface=/var/run/wpa_supplicant
@@ -183,22 +183,22 @@ network={
<a name="poweron"></a>
<h2>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>.
<p>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>.</p>
![Login page kerberos.io webinterface](1_how-to-access.png)
<a name="access"></a>
<h2>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>.
<p>To use Kerberos.io you only need access to the webinterface, however you can also <b>access the system with SSH</b>.</p>
<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.
<p>Note that by default no root password is set, you can define a password in the <b>/data/etc/kios.conf</b> file.</p>
<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.
<p>Add your password, save the file and reboot the system.</p>