__TOC__
<br>
<big>Welcome to Amahi 11!</big>
These instructions below will guide you through the Amahi 11 Express CD installation, step by step, with screenshots. This is the recommended method for quick download and fast setup.
Should the Amahi 11 Express CD not work for you, there are two alternate install methods for Fedora and Amahi 11: [[Fedora_27_Server_CD_Install|Minimal CD]], so-called Netinstall or [[Fedora_27_Server_DVD_Install|Full (DVD) install]] (provides additional hardware support).
<br>
'''NOTES:'''
* 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 [https://www.amahi.org/apps App Store] before proceeding.
* You must install Fedora 27 Server prior to installing Amahi 11. <br>
For assistance, visit the [https://forums.amahi.org Amahi Forums] or live support on the [http://talk.amahi.org Amahi IRC channel].
= Install Fedora 27Prerequisites =There are two ways You need to obtain an install Fedora: Minimal code (CDdenoted YOUR-INSTALL-CODE below), so-called Netinstall, which is recommended, and from the [[Fedora_27_Server_DVD_Install|Full (DVD) install]https://www.amahi.org/users Amahi control panel] after configuring a profile for the system you are installing, with '''proper network configuration''' for cases that need additional hardware supportyour network.
We recommend this method for Express CD is preconfigured as follows:* '''LOCALIZATION:'''** '''KEYBOARD:''' defaults to ''English (US)''.** '''LANGUAGE:''' defaults to ''English''.** '''TIME AND DATE:''' defaults to server time zone.* '''SOFTWARE:''' ''Minimal Install'' and should not be changed.* '''INSTALLATION DESTINATION:''' defaults to the first hard drive in a quick download and fast installationmulti-drive system.* '''NETWORK & HOST NAME:''' detected automatically.* '''USER SETTINGS''': user ''admin'' is preconfigured with a password of ''administrator''.
= Download =* Amahi 11 Express CD (based on Fedora 27 Server Netinstall CD ) for 64 bit (484MB577MB)** Primary: Torrent - [httpshttp://downloaddl.fedoraprojectamahi.org/pub/fedora/linux/releases/27/Server/x86_64/isoisos/FedoraAmahi-Server-netinst11-x86_64-27-1.6.iso Fedora-Servertorrent Amahi-netinst11-x86_64-27-1.6.isotorrent]<code>(MD5 e32fb303d6488e98078042dc2d162d08)</code>** Alternate: Direct Download - [httpshttp://dl.fedoraprojectamahi.org/pub/fedora/linux/releases/27/Server/x86_64/isoisos/FedoraAmahi-Server-netinst11-x86_64-27-1.6.iso FedoraAmahi-Server-netinst11-x86_64-27-1.6.iso]<code>(SHA1 cf972ec23f0c6b873884b80b4010b9b2b03be14a)</code>
* Burn the ISO to CD/DVD (or [[USB Install|USB]]), insert the media into your server, and reboot boot the system.
* These The instructions below will guide you through the Fedora 27 Netinstall CD installation with have 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 '''[<Screenshot>]''' to show/hide the image.
==Boot Screen==
<ul>
<li>Select ''Install Fedora 27Amahi 11''<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS0A11E-SS0.PNG|600px]]
</div><br></li>
</ul>
<ul>
<li>Choose desired language and select ''Continue''
<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS1A11E-SS1.PNG|600px]]
</div><br></li>
</ul>
==Installation Summary==
<ul>
<li>The '''INSTALLATION SUMMARY''' screen will appear. It may take a few minutes to finish ''Checking software dependenciesDownloading package metadata''<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:A11E-SS3.PNG|600px]] </div><br><li>Choose '''AMAHI SERVER SETUP''' and enter YOUR-INSTALL-CODE obtained earlier followed by '''Done'''.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS2AA11E-SS6.PNG|600px]]
</div><br></li>
<li>Change the Select '''KEYBOARD''' or and choose the default layout followed by '''TIME & DATEDone''' to match your locale if needed.</li><li> Verify '''NETWORK & HOST NAME''' indicates ''connected''. Don't make any changes unless you are sure of what you are doing.</li> <li>Once complete, next choose ''INSTALLATION DESTINATION''. This is where you will select the disk drive to use.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS2BA11E-SS4.PNG|600px]]
</div><br></li>
</ul>
==Disk Drive Setup==
<div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #FFB6C1; margin: 3px 3px 1em 3px;">'''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.</div>
<ul>
<li>Choose the disk drive you want to use for the Fedora installation. If you have more than one disk drive connectedyour keyboard layout is not listed, '''DO NOT''' select them at this time. You will notice a ''check mark'' on the disk drive selected. Select ''I will configure partitioning'' plus sign (+) and then choose ''Done''add the desired layout.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3AA11E-SS5.PNG|600px]]
</div><br></li>
<li>Should you have existing partitions on Choose the disk drive you will be using for the Fedora 27 installation, they will have to be removeddesired layout followed by '''Done'''.</li></ul><li>Verify:</li>
<ul>
<li> You should see the existing partition about half way down the screen.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3B.PNG|600px]] </div></li><li>Choose it to expand '''TIME & DATE''' and display the existing partitions for deletion. Select the first partition in the list followed by the minus (-) sign.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3C.PNG|600px]] </div></li><li> When prompted Are you sure you want change to delete all the data on ..., choose Delete It.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3Dmatch your locale if needed.PNG|400px]] </div></li><li> Repeat the previous two steps until all the existing partitions on the disk drive are gone.</li></ul> <li>Ensure the ''New mount points will use the following partitioning scheme:'' is changed to reflect '''Standard partition'''. Then select INSTALLATION DESTINATION''Click here to create them automatically''.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3E.PNG|600px]] </div><br></li> <li>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 indicates the correct hard drive partition scheme documentation as a guide. Once complete, choose ''Done''<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS3Fif you have more than one connected.PNG|600px]] </div><br></li> <li>You will now see '''SUMMARY OF CHANGESNETWORK & HOST NAME''' to the disk drive. Choose indicates ''Accept Changesconnected''<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" . style="width:400px">[[file:F27CD_SS3GDon't make any changes unless you are sure of what you are doing.PNG|600px]] </div><br></li>
</ul>
==Software Selection==
<ul>
<li>Next on the '''INSTALLATION SUMMARY''', select ''SOFTWARE SELECTION''
<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">
[[file:F27CD_SS4A.PNG|600px]]
</div><br></li>
<li>Select ''Minimal Install'' and then choose ''Done''
<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">
[[file:F27CD_SS4B.PNG|600px]]
</div><br></li>
</ul>
<ul>
<li>Back to the '''INSTALLATION SUMMARY''' and ready to begin installation. Select ''Begin Installation''
<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS5A11E-SS7.PNG|600px]]
</div><br></li>
</ul>
==Initial User CreationInstallation Progress==
<ul>
<li>Installation has begun and we need to create Now all of the initial userconfiguration steps are complete. '''DO NOT''' set Sit back and watch the root passwordprogress.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px600px">[[file:F27CD_SS6AA11E-SS8.PNG|600px]]
</div><br></li>
<li>Once installation is complete, the machine will automatically reboot. You '''MUST''' create the initial user and password (This will be your HDA Login, also called next see see a black screen with no graphics displaying the First Admin User)Amahi 11 installation progress. Ensure you select ''Make this user administrator When it'' check box. Once completes finished, choose ''Done''. Note that a weak password may require you to select ''Done'' twicethe machine will again reboot automatically.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD_SS6BA11E-SS10.PNG|600px800px]]
</div><br></li>
</ul> ==Installation Progress==<ul><li>Now all of the configuration steps are Once reboot is complete. Sit back and watch , you should have a fully functional home server using the progress.IP address set up in your network! <div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD SS7A11E-SS11.PNG|600px200px]]
</div><br></li>
</ul>
==Installation Complete==<ul><li>Installation is complete. Choose ''Reboot'' and remove the installation media.<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:F27CD SS8.PNG|600px]] </div><br></li></ul> = Install Amahi 11 = Next, we will install Amahi 11 proper on top of Fedora 27.<ul><li>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)<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:A11_SS1.PNG|450px]] </div><br><br> :'''NOTE:''' Passwords do not echo characters on the screen. <li>You need to obtain an install code (denoted YOUR-INSTALL-CODE below) from the [https://www.amahi.org/users Amahi control panel] after configuring a profile for the system you are installing, with '''proper network configuration''' for your network.<br><br> <li>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.<br /> <div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left"> sudo su -</div> <li>After that, type these three separate commands (one per line) in the console: <div style="border: 1px solid #A3B1BF; padding: .5em 1em; color: #000; background-color: #E6F2FF; margin: 3px 3px 1em 3px; text-align: left"> <nowiki>rpm -Uvh http://f27.amahi.org/noarch/hda-release-10.5.0-1.noarch.rpm</nowiki> dnf -y install hda-ctl hda-install -i YOUR-INSTALL-CODE</div></ul>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 [https://www.amahi.org/users 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!
Once installed, you will want to transition your network to using your Amahi server. Here are some of the things you should know:
<ul>* <li>Your server will boot with the static IP you pre-configured in the Amahi control panel</li>* <li>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''' [[Amahi_8_Troubleshooting#Virtualization_Stack_Breaks_DNS.2FDHCP_Server|(details)]]</li>* <li>It's strongly recommended you follow the [[transition to Amahi]] HDA guide to get your network fully working properly</li>* <li>You can verify if the dashboard is available by accessing it from any client using the IP address of your server '''<nowiki>http://IPADDRESS/</nowiki>''' or '''<nowiki>http://hda/</nowiki>''' (in most Windows clients this works even without DNS from your HDA)</li>* <li>The first time it will initializeyou access the dashboard, ask you will need to login, with user name and enter a dashboard passwordas noted above in [[Amahi_11_Install#Prerequisites|Prerequisites]].<div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:A11-SS1.PNG|250px]] * </div><br></li><li>Once you reach your dashboard, recommend you configure your HDA [[Setup|dashboardsettings]], you should [[Storage_and_file_sharing|create /manage shares]] as needed, [[Adding_a_second_hard_drive_to_your_HDA|add more drivesstorage space]], install apps, etc.* <div class="mw-collapsible mw-collapsed" data-collapsetext="{{int:Screenshot}}" style="width:400px">[[file:A11-SS2.PNG|400px]] </div><br></li><li>Optionally refer to [[Greyhole#Amahi_7.2F8|Greyhole]] to install/configure storage pooling.</li></ul>
= Troubleshooting =