kobol-wiki/docs/install.md

!!! info Wiki edition in progress

!!! note Go to Starter Kit to find out how to put together your Helios4 NAS

What you need before you start.

1. microSD Card
You need a microSD Card UHS-I with a minimum of 8GB. Ideally Speed Class 3.
We recommend the following models:
- Samsung Evo Pro+ 32GB
- SanDisk Extreme Pro 32GB

2. Micro-USB to USB cable

3. Ethernet cable (cat5/6)

Step 1 - Download an Helios4 build image

You will need first to download a build image to write on the microSD Card.

Go to Dowload and chose one of the latest build.

Step 2 - Writing an image to a microSD Card

You will need to use an image writing tool to install on your microSD Card the build image you have downloaded.

Under Windows, Mac OS or Linux (via Graphic Interface)

Etcher is a graphical SD card writing tool that works on Mac OS, Linux and Windows, and is the easiest option for most users. Etcher also supports writing images directly from XZ files, without any prerequired decompression. To write your image with Etcher:

• Download Etcher and install it on your computer.
• Insert the microSD Card inside your SD card reader (microSD to SD adapter might be needed).
• Open Etcher and select from your local storage the Helios4 .img.xz file you wish to write to the microSD Card.
• Select the microSD Card you wish to write your image to.
• Review your selections and click 'Flash!' to begin writing data to the microSD Card.

Under Linux (via CLI)

$ unxz Helios4_Debian_Jessie_4.4.96.img.xz

$ dd bs=4M if=Helios4_Debian_Jessie_4.4.96.img of=/dev/sdX conv=fsync

Step 3 - Power-up Helios4

Before powering-up insure :

1. You inserted the microSD Card that you prepared in the previous step.

2. You connected your computer to the serial port with the Micro-USB to USB cable.

3. You connected Helios4 to your home network with the Ethernet cable.

4. You plugged-in properly the DC power connector before powering-up the AC adapter.

Now you can plug-in / power-up the AC adapter.

Step 4 - Connect to Helios4 serial console

Under Windows

1. Download PuTTY and install it on your computer.

2. Setup serial port settings (Speed : 115200 and Flow control : None).
   

3. Select serial and click 'Open'.
   

!!! note If you computer already has a serial port then COM1 might not be the correct serial line to connect to Helios4. Check this link to learn how to determine the right COM port.

Under Linux (via CLI)

1. Install and launch minicom

$ sudo apt-get install minicom
$ sudo minicom -D /dev/ttyUSB0 -b 115200

2. Setup serial port settings
   press CTRL-A O, then go to menu 'Serial port setup'.

3. Disable Hardware Flow control
   press F, then press ESC twice.

Step 5 - Log in

!!! note You might need to press enter for the login prompt to come up.

Default credential for Debian image

helios4 login: root
Password: 1234

You will be prompted to change the root password and then create a new user account.

Default credential for OpenMediaVault image

helios4 login: root
Password: openmediavault

You will be prompted to change the root password.

Step 6 - Check/Set IP address

By default Helios4 will try to obtain an IP address via DHCP. To figure out what is the allocated IP address you will need to type the following command in the console.

$ ifconfig eth0

Here the IP address of Helios4 is 10.10.10.1.

If you wish to manually configure your IP address refer to the following Debian Wiki Page.

!!! note Openmediavault comes with mDNS server (Avahi daemon). Therefore if your desktop/laptop runs a mDNS client you can reach the board via the following hostname address : helios4.local

What to do next ?

If you have installed an OpenMediaVault image, refer to the OMV page for further instructions.

Otherwise you can now connect by SSH to your Helios4 to carry on with your manual configuration.