Differences
This shows you the differences between two versions of the page.
en:quick_start_guide [2014/09/04 14:03] admin [What you will need] |
en:quick_start_guide [2016/01/13 20:28] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Calaos quick start guide ====== | ||
- | |||
- | ====== Raspberry pi quick start guide ====== | ||
- | ===== What you need ===== | ||
- | * A computer with Linux, MacosX or Windows | ||
- | * A Raspberry pi, Model B | ||
- | * An SD Card, We recommend an 2GB class 10 SD card (class 4 can be broken much more quickly) | ||
- | * Download the latest official calaos image for raspberrypi :[[ http:// | ||
- | |||
- | ====== Creating the SD card with calaos os ====== | ||
- | === Linux === | ||
- | Launch a terminal and go in the directory where you download the calaos os image. | ||
- | |||
- | $ cd ~/Downloads | ||
- | $ tar xvf calaos-image-raspberrypi-2014-04-28.tar.xz | ||
- | |||
- | Insert the sdcard into the sdcard reader of your PC. | ||
- | You need to know what's the device created by linux when the card is inserted. The device name is something like /dev/sdX or / | ||
- | To know the exact name use the following command : | ||
- | |||
- | $ dmesg | tail | ||
- | |||
- | |||
- | You should get something like that : | ||
- | |||
- | | ||
- | | ||
- | | ||
- | |||
- | In that case the device is / | ||
- | |||
- | We need to ensure that this device is not mounted on your system | ||
- | |||
- | $ sudo unmount / | ||
- | $ sudo unmount / | ||
- | ... | ||
- | |||
- | or in case your device is detected as /dev/sdX | ||
- | |||
- | $ sudo unmount /dev/sdd1 | ||
- | $ sudo unmount /dev/sdd2 | ||
- | ... | ||
- | |||
- | You can verify that the devices are not mounted by using the mount command | ||
- | |||
- | $ mount | ||
- | |||
- | No sdcard must appears in the resulting list. | ||
- | |||
- | Let's now copy the **calaos os** on the sdcard | ||
- | |||
- | sudo dd if=calaos-image-raspberrypi-2014-04-28.sdimg of=/ | ||
- | |||
- | Once the operation is terminated, you can remove the sdcard, and insert it in the Raspberry pi. | ||
- | |||
- | |||
- | === Macos === | ||
- | |||
- | You can use ApplePi-Baker. It's a free utility tha allows you to write an image to the sdcard. | ||
- | It can be download here : [[http:// | ||
- | |||
- | === Windows === | ||
- | You can use Win32DiskImager. You can download it here : [[http:// | ||
- | |||
- | ====== Connecting to the Rpi ====== | ||
- | |||
- | When you boot the raspberrypi, | ||
- | |||
- | ssh root@rasberrypi | ||
- | |||
- | If you already know the IP address, just connect directly : | ||
- | |||
- | ssh root@ip_address | ||
- | |||
- | The default password is empty. | ||
- | If you have trouble to find the ip adress, look here : http:// | ||
- | |||
- | NOTE : on Linux and MacosX you can use the Terminal to use ssh. On windows you need a program like putty to connect to the raspberrypi : [[http:// | ||
- | |||
- | ====== | ||
- | |||
- | The first thing to do is to start calaos_server to let him create a defaut set of config files in /etc/calaos : | ||
- | |||
- | systemctl start calaos-server | ||
- | |||
- | Then you can set the basic parameters of your calaos installation : username and password. | ||
- | |||
- | $ calaos_config set cn_user nico | ||
- | $ calaos_config set cn_pass calaos_rox | ||
- | |||
- | These user and password are those that you will use to connect from Calaos Web, Calaos Home or Calaos Installer. | ||
- | By default when you boot the raspberrypi with a **Calaos OS** image, calaos-server is not started automatically. | ||
- | If you want it activated every time you start the card, enable it at startup with the following command : | ||
- | |||
- | | ||
- | |||
- | To see if everything is working fine with calaos server, you can try to connect to the server via Calaos Web. Start your favorite web browser and connect to http:// | ||
- | You should be able to login, but nothing is displayed in the interface. It's completely **normal** as we don't have configured the whole installation yet. What we need now is to create the configuration of our house, and Calaos Installer will be used for that. | ||
- | |||
- | ====== | ||
- | |||
- | Calaos Installer is an application for Linux, Macos X and Windows. | ||
- | You can download it here : TBD | ||