diff --git a/docs/armbian.md b/docs/armbian.md new file mode 100644 index 0000000..5a0c0ad --- /dev/null +++ b/docs/armbian.md @@ -0,0 +1,30 @@ +# Armbian # + +Debian based Linux for ARM based single-board computers + +[https://www.armbian.com](https://www.armbian.com "Armbian") + + +# How to build an image or a kernel? + +Supported build environment is **Ubuntu Bionic 18.04 x64** ([minimal iso image](http://archive.ubuntu.com/ubuntu/dists/bionic/main/installer-amd64/current/images/netboot/mini.iso)). + +- guest inside a [VirtualBox](https://www.virtualbox.org/wiki/Downloads) or other virtualization software, +- guest managed by [Vagrant](https://www.vagrantup.com/). This uses Virtualbox (as above) but does so in an easily repeatable way. Please check the [Armbian with Vagrant README](https://docs.armbian.com/Developer-Guide_Using-Vagrant/) for a quick start HOWTO, +- inside a [Docker](https://www.docker.com/), [systemd-nspawn](https://www.freedesktop.org/software/systemd/man/systemd-nspawn.html) or other container environment [(example)](https://github.com/armbian/build/pull/255#issuecomment-205045273), +- running natively on a dedicated PC or a server (**not** recommended), +- **20GB disk space** or more and **2GB RAM** or more available for the VM, container or native OS, +- superuser rights (configured `sudo` or root access). + +**Execution** + + apt-get -y install git + git clone https://github.com/armbian/build + cd build + ./compile.sh + +Make sure that full path to the build script does not contain spaces. + +You will be prompted with a selection menu for a build option, a board name, a kernel branch and an OS release. Please check the documentation for [advanced options](https://docs.armbian.com/Developer-Guide_Build-Options/) and [additional customization](https://docs.armbian.com/Developer-Guide_User-Configurations/). + +Build process uses caching for the compilation and the debootstrap process, so consecutive runs with similar settings will be much faster. diff --git a/docs/img/install/ssh_login.png b/docs/img/install/ssh_login.png index f8ad6c9..ba760d3 100644 Binary files a/docs/img/install/ssh_login.png and b/docs/img/install/ssh_login.png differ diff --git a/docs/img/omv/install-1.png b/docs/img/omv/install-1.png new file mode 100644 index 0000000..5ad9d63 Binary files /dev/null and b/docs/img/omv/install-1.png differ diff --git a/docs/img/omv/install-2.png b/docs/img/omv/install-2.png new file mode 100644 index 0000000..44e200a Binary files /dev/null and b/docs/img/omv/install-2.png differ diff --git a/docs/img/omv/install-3.png b/docs/img/omv/install-3.png new file mode 100644 index 0000000..fc2ed5a Binary files /dev/null and b/docs/img/omv/install-3.png differ diff --git a/docs/img/omv/install-4.png b/docs/img/omv/install-4.png new file mode 100644 index 0000000..907c93c Binary files /dev/null and b/docs/img/omv/install-4.png differ diff --git a/docs/install.md b/docs/install.md index 7b038f6..e1bff97 100644 --- a/docs/install.md +++ b/docs/install.md @@ -45,9 +45,9 @@ Etcher is a graphical SD card writing tool that works on Mac OS, Linux and Windo ### Under Linux (via Terminal) ```bash -$ unxz Helios4_Debian_Jessie_4.4.96.img.xz +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 +sudo dd bs=4M if=Helios4_Debian_Jessie_4.4.96.img of=/dev/sdX conv=fsync ``` !!! note @@ -134,7 +134,7 @@ You will be prompted to change the root password. 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. ```bash -$ ifconfig eth0 +sudo ifconfig eth0 ``` ![Network Config](/img/install/network_config.png) @@ -149,7 +149,7 @@ Here the IP address of Helios4 is **10.10.10.1**. If you wish to manually configure your IP address you can use the **armbian-config** tool. ```bash -$ sudo armbian-config +sudo armbian-config ``` ![Armbian-config](/img/install/armbian-config.png) @@ -160,22 +160,24 @@ $ sudo armbian-config ![Armbian-config](/img/install/armbian-config_ip.png) +Press **ESC** till you exit armbian-config tool. + You will have to reboot for the network settings to take effect. ```bash -$ sudo reboot +sudo reboot ``` !!! info You can also refer to the following Debian Wiki [Page](https://wiki.debian.org/NetworkConfiguration#Setting_up_an_Ethernet_Interface) for advanced network settings. +## **Step 7** - Connect to Helios4 via SSH - -## **What to do next ?** - -**If you have installed an OpenMediaVault image, refer to the [OMV page](/omv) for further instructions.** - -Otherwise you can now connect by SSH to your Helios4 to carry on with your configuration. +You can now connect by SSH to your Helios4 to carry on with your configuration. ![SSH Login](/img/install/ssh_login.png) ![Putty SSH](/img/install/putty_ssh.png) + +## **What to do next ?** + +If you want to install OpenMediaVault, the next-gen network attached storage (NAS) software, refer to the [OMV](/omv) page. diff --git a/docs/linux.md b/docs/linux.md deleted file mode 100644 index f95d487..0000000 --- a/docs/linux.md +++ /dev/null @@ -1,2 +0,0 @@ -!!! info - To be done. diff --git a/docs/omv.md b/docs/omv.md index 91aeecd..5c56ff6 100644 --- a/docs/omv.md +++ b/docs/omv.md @@ -1,9 +1,42 @@ This is a basic guide to help you setting up Helios4 NAS with [OpenMediaVault](https://www.openmediavault.org/) (**OMV**). OMV offers a large collection of features that we don't cover here. We invite you to look online for the existing OMV guides or go on the [OMV forum](https://forum.openmediavault.org/index.php/Board/29-Guides/). +!!! info + The following guide was written for OMV3 (OpenMediaVault 3.X). It should still apply to OMV4. + ## What is OpenMediaVault? OpenMediaVault (OMV) is a next-gen network attached storage (NAS) software based on Debian Linux. It contains services like SSH, (S)FTP, SMB/CIFS, DAAP media server, RSync, BitTorrent client and many more... all configurable via a Web Control Panel. Thanks to a modular framework design, new features can be added to OMV via plugins. It is a simple and easy to use out-of-the-box solution that will allow everyone to install and administrate a Network Attached Storage without deeper knowledge. +## Install Openmediavault + +You can easily install OMV with the **armbian-config** tool. + +!!! note + If you have installed a pre-built OpenMediaVault image you can skip this step. + +Connect to your Helios4 via SSH as explained [here](/install/#step-7-connect-to-helios4-via-ssh). + +Launch **armbian-config** and follow the steps. + +```bash +sudo armbian-config +``` + +![!armbian-config Main Menu](/img/omv/install-1.png) + +![!armbian-config Software](/img/omv/install-2.png) + +![!armbian-config Selection](/img/omv/install-3.png) + +![!armbian-config Install](/img/omv/install-4.png) + +When installation is completed, press **ESC** till you exit armbian-config tool. + +You might want to reboot to be sure all OMV services are started properly. +```bash +sudo reboot +``` + ## Connect to OpenMediaVault (OMV) Control Panel Open your web browser and go to the one of the following addresses : @@ -326,7 +359,7 @@ You can repeat the above steps to connect to your other Share Folders. ### Using Terminal ```bash -$ mount -t cifs //10.10.10.1/movie /mnt -o username=anonymous +mount -t cifs //10.10.10.1/movie /mnt -o username=anonymous ``` ## Accessing Shared Folder (Windows) diff --git a/mkdocs.yml b/mkdocs.yml index ad87e72..14d313a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -39,7 +39,7 @@ extra: - type: 'rss-square' link: 'https://blog.kobol.io' sd_release: - latest: '17/02/2018' + latest: '04/07/2018' # Google Analytics google_analytics: