Getting started

Let's start with Cloudy!

 


 

 

Requirements

As it is a Debian based system, it has the same hardware requirements.

The image of Cloudy has a set of configurations and additional packages; so it needs around 450 MiB of storage space.

However, its recommended to have at least 1 GiB.

Of course, if you want to use some services like Peerstreamer (see features page), the minimum requirements will increase.

 


 

Get Cloudy

Actually you can get Cloudy distribution by downloading an ISO image ready to install in a CD/DVD or USB memory stick, or a Linux container template (LXC or OpenVZ) to execute it directly virtualised.

Otherwise, you can download the source code and compile it yourself.

Download the image

Go to the Download page to access where the images are stored.

Burn the ISO image (Linux)

The ISO files are live install CD images, i.e. they have an installation system which is executed directly at boot from the external device (CD/DVD/USB).

You can burn it in:

  • CD/DVD:
$ apt-get install xorriso
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso
  • USB:
$ dd if=cloudy.iso of=${USBSTICK}

Compile

Optionally you can built Cloudy from your own. Go to Development page to know how to.

 


Install

As it is already explained, the distribution is based on Debian GNU/Linux and contained in a live ISO image.

You can try to boot the system from the external device (CD/DVD/USB), either to start the installation process, selecting the corresponding option in the menu.

cloudy-boot-install

The installation is the same as with a standard Debian, and it can be summarised in:

  1. Choose the option Install in the first steps boot menu. (min 0:06)
  2. Select the installation and system default language. (min 0:12)
  3. Select your location. (min 0:16)
  4. Select the keyboard layout. (min 0:19)
  5. Change/assign the hostname. (min 1:21)
  6. Add the password for root user. (min 1:37)
  7. Create a new user account with password. (min 1:45)
  8. Partition the disk. In the example it is used the whole disk with only one partition. (min 2:02)
  9. Configure the package manager selecting the nearest Debian repository mirror. (min 3:10)
  10. Install the GRUB boot loader in the disk's master boot record (MBR). (min 4:34)
  11. End the installation and reboot the machine to start your new system. (min 4:43)

NOTE: the references between brackets correspond to the approximate time in the Cloudy installation example video.

How to update

The update system allows you to check and upgrade the Cloudy packages to avoid reinstalling the whole system and losing the data.

In the actual version, in the System > Update menu you can check if there are updates of Cloudy packages and upgrade one to one. Also there is an option to do a system upgrade (Debian packages).

Cloudy-update

You can see here an example video of the update system.

 


First steps

To access the web management interface you have to open your browser and type the address of the Cloudy machine in the port 7000.

http://ADDRESS:7000

Credentials:

  • User: root
  • Password: root (by default in the container, and selected by you during the installation with the ISO image)
Cloudy-home

Once logged in we can see the start page with general information of the system and a top menu with different sections, divided into two parts.

1. In the left there are the options to configure and manage the system.

  • Cloudy: start page.
  • System: updates, user configurations, log out.
  • Languages: language selection.

2. In the right there are the options to configure and manage the services.

  • Search: tools to announce and discover services in the network. Allows different software for this purpose.
  • Clommunity: services introduced in the CLOMMUNITY project.
  • Guifi.net: common services used in the community network Guifi.net.

 

You can read in the Features page more about the supported services.