Amahi 11 Install

	Work In Progress
	This article is currently undergoing major expansion or restructuring. You are welcome to assist by editing it as well. If this article has not been edited in several days, please remove this template.

NOTES:

• The only officially supported install media is Fedora 27 Server.
• Ensure your system meets the minimum hardware requirements for Amahi before proceeding.
• 32-bit installs are not available nor supported in Amahi 11.
• NOT ALL apps in previous Amahi versions are available for Amahi 11. Check the App Store before proceeding.
• You must install Fedora 27 Server prior to installing Amahi 11.

For assistance, visit the Amahi Forums or live support on the Amahi IRC channel.

Install Fedora 27

There are two ways to install Fedora: Minimal (CD), so-called Netinstall, which is recommended, and the Full (DVD) install for cases that need additional hardware support.

We recommend this method for a quick download and fast installation.

• Fedora 27 Workstation Netinstall CD for 64 bit (484MB, Checksum SHA1 10957f5e347c9ef9d0d41faee13e60c808226f7c).
  • Primary: Fedora-Workstation-netinst-x86_64-27-1.6.iso
  • Alternate: Fedora-Workstation-netinst-x86_64-27-1.6.iso

• Burn the ISO to CD/DVD (or USB), insert the media into your server, and reboot the system.

• These instructions below will guide you through the Fedora 27 Netinstall CD installation with screen shots and commentary. If you are not an advanced Linux user and know what you are doing, recommend you DO NOT deviate from the guidance. Click [Collapse] to show a screen shot or to hide it.

Boot Screen

• Select Install Fedora 27

  

  
  

Language Selection

• Choose desired language and select Continue

  

  
  

Installation Summary

• The INSTALLATION SUMMARY screen will appear. It may take a few minutes to finish Checking software dependencies

  

  
  
• Change the KEYBOARD or TIME & DATE to match your locale if needed.
• Verify NETWORK & HOST NAME indicates connected. Don't make any changes unless you are sure of what you are doing.
• Once complete, next choose INSTALLATION DESTINATION. This is where you will select the disk drive to use.

  

  
  

Disk Drive Setup

WARNING: Amahi staff doesn't recommend using the default LVM partition scheme. Doing so will dedicate most of the drive space in the system to the /home partition. Amahi does not utilize this space, limiting storage for file shares and web applications. For best results and maximum storage, use the Standard partition scheme.

• Choose the disk drive you want to use for the Fedora installation. If you have more than one disk drive connected, DO NOT select them at this time. You will notice a check mark on the disk drive selected. Select I will configure partitioning and then choose Done.

  

  
  
• Should you have existing partitions on the disk drive you will be using for the Fedora 27 installation, they will have to be removed.
• You should see the existing partition about half way down the screen.

  

• Choose it to expand and display the existing partitions for deletion. Select the first partition in the list followed by the minus (-) sign.

  

• When prompted Are you sure you want to delete all the data on ..., choose Delete It.

  

• Repeat the previous two steps until all the existing partitions on the disk drive are gone.
• Ensure the New mount points will use the following partitioning scheme: is changed to reflect Standard partition. Then select Click here to create them automatically.

  

  
  
• The disk drive partition should look similar to this setup. For most users, then default partitioning scheme used will suffice. However, you can manually change it using the hard drive partition scheme documentation as a guide. Once complete, choose Done

  

  
  
• You will now see SUMMARY OF CHANGES to the disk drive. Choose Accept Changes

  

  
  

Software Selection

• Next on the INSTALLATION SUMMARY, select SOFTWARE SELECTION

  

  
  
• Select Minimal Install and then choose Done

  

  
  

Begin Installation

• Back to the INSTALLATION SUMMARY and ready to begin installation. Select Begin Installation

  

  
  

Initial User Creation

• Installation has begun and we need to create the initial user. DO NOT set the root password.

  

  
  
• You MUST create the initial user and password (This will be your HDA Login, also called the First Admin User). Ensure you select Make this user administrator check box. Once complete, choose Done. Note that a weak password may require you to select Done twice.

  

  
  

Installation Progress

• Now all of the configuration steps are complete. Sit back and watch the progress.

  

  
  

Installation Complete

• Installation is complete. Choose Reboot and remove the installation media.

  

  
  

Install Amahi 11

Next, we will install Amahi 11 proper on top of Fedora 27.

• When you reboot you will see a black screen with no graphics and a "localhost login" text prompt. Login into that that console directly with the user and password you created in the Fedora 27 installation. (You can also use SSH to login remotely from a client if you know how)

  

  
  
  

  NOTE: Passwords do not echo characters on the screen.

• You need to obtain an install code (denoted YOUR-INSTALL-CODE below) from the Amahi control panel after configuring a profile for the system you are installing, with proper network configuration for your network.
  
  
• From text console or using SSH (logged in with the user created in the Fedora 27 installation), become root for the Amahi installation. When prompted for a password, it's your user password you set in the Fedora 27 install.
  

   sudo su -
  

• After that, type these three separate commands (one per line) in the console:

     rpm -Uvh http://f27.amahi.org/noarch/hda-release-10.5.0-1.noarch.rpm
    dnf -y install hda-ctl
    hda-install YOUR-INSTALL-CODE
  

What this does is installs the Amahi F27 repo, gets the mariadb base packages to avoid dependency conflicts, and installs base Amahi packages (that part should install several packages).

If there are no errors, install Amahi (replace YOUR-INSTALL-CODE above with install code you got when creating a profile at your Amahi control panel).

If all goes well, it should tell you to reboot. Go ahead and reboot!

Once it comes back from the reboot, you should have a fully functional home server using the IP address you set up in your network!

Next you need to transition your network to use it!

Transitioning to your Amahi server

Once installed, you will want to transition your network to using your Amahi server. Here are some of the things you should know:

• Your server will boot with the static IP you pre-configured in the Amahi control panel
• This is a headless server, therefore it will boot to a text console. There is no desktop user interface. Installing the Desktop (e.g. GNOME) interface will break DNS/DHCP and make the HDA as an unsuitable network server (details)
• It's strongly recommended you follow the transition to Amahi HDA guide to get your network fully working properly
• You can verify if the dashboard is available by accessing it from any client using the IP address of your server http://IPADDRESS/ or http://hda/ (in most Windows clients this works even without DNS from your HDA)
• The first time it will initialize, ask you to login, and enter a dashboard password.
• Once you reach your dashboard, you should create shares as needed, add more drives, install apps, etc., etc.
• Optionally refer to Greyhole to install/configure storage pooling.

Troubleshooting

Visit the troubleshooting page if you find yourself in trouble.

Reference

Refer to the HDA Admin How To page for Amahi Server administrator guidance.

Go back to Amahi Docs page.