+-->
+
+<a name="installsh">
+<h2>Installing rEFInd Using <tt>install.sh</tt> under Linux or Mac OS X</h2>
+
+<p class="sidebar"><b>Warning:</b> If you're using a Macintosh, you should run <tt>install.sh</tt> from Mac OS X rather than from Linux. If run from Linux, rEFInd is unlikely to be fully installed. Worse, it's conceivable that running <tt>install.sh</tt> from Linux will damage your firmware, requiring that it be re-flashed. The reason is that Apple uses non-standard methods to enable a boot loader, and the Linux functions in <tt>install.sh</tt> assume standard EFI installation methods.</p>
+
+<p>If you're using Linux or Mac OS X, the easiest way to install rEFInd is to use the <tt>install.sh</tt> script. Under Linux, this script installs rEFInd to your disk's ESP. Under Mac OS X, the script installs rEFInd to your current OS X boot partition by default; but you can install to your ESP instead by passing the script the <tt>esp</tt> option.</p>
+
+<p>Before running this script under Linux, you should ensure that your ESP is mounted at <tt>/boot</tt> or <tt>/boot/efi</tt>, as described in more detail in the <a href="#linux">Installing rEFInd Manually Using Linux</a> section. (If you installed Linux in EFI mode, chances are your ESP is properly mounted.) This precaution isn't necessary under OS X.</p>
+
+<p>A sample run under Linux looks something like this:</p>
+
+<pre class="listing">
+# <tt class="userinput">./install.sh</tt>
+Installing rEFInd on Linux....
+ESP was found at /boot/efi using vfat
+Copied rEFInd binary file refind_x64.efi
+
+Copying sample configuration file as refind.conf; edit this file to configure
+rEFInd.
+
+
+Installation has completed successfully.</pre>
+
+<p>The output under OS X is a bit different:</p>
+
+<pre class="listing">
+$ <tt class="userinput">./install.sh</tt>
+Not running as root; attempting to elevate privileges via sudo....
+Password:
+Installing rEFInd on OS X....
+Installing rEFInd to the partition mounted at '/'
+Copied rEFInd binary file refind_ia32.efi
+
+Copying sample configuration file as refind.conf; edit this file to configure
+rEFInd.
+
+
+WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the
+bless status with 'bless --info', since this is known to cause disk corruption
+on some systems!!
+
+
+Installation has completed successfully.</pre>
+
+<p>In either case, the details of the output differ depending on your existing configuration and how you ran the program. Some details that can affect how the script runs include the following:</p>
+
+<ul>
+
+<li>If you run the script as an ordinary user, it attempts to acquire
+ <tt>root</tt> privileges by using the <tt>sudo</tt> command. This works
+ on Mac OS X and some Linux installations (such as under Ubuntu or if
+ you've added yourself to the <tt>sudo</tt> users list), but on some
+ Linux installations this will fail. On such systems, you should run
+ <tt>install.sh</tt> as <tt>root</tt>.</li>
+
+<li>Under OS X, you can run the script with a mouse by opening a Terminal
+ session and then dragging-and-dropping the <tt>install.sh</tt> file to
+ the Terminal window. You'll need to press the Return or Enter key to
+ run the script.</li>
+
+<li>Under OS X, passing the "esp" option causes the script to install
+ rEFInd to the ESP. The script finds the first ESP that's identified by
+ the <tt>diskutil</tt> program and, if it's not already mounted, mounts
+ it to install rEFInd. Thus, it's conceivable that <tt>install.sh</tt>
+ will install rEFInd to the wrong partition if you have multiple disks
+ or if a disk has multiple ESPs. If you believe this has happened, you
+ may need to re-install manually.</li>
+
+<li>If you're using OS X 10.7's Whole Disk Encryption (WDE) feature, you
+ <i>must</i> install rEFInd to the ESP, so the <tt>esp</tt> option to
+ <tt>install.sh</tt> is required. I'm still a little bit foggy about
+ what's required to boot the system once this is done; see <a
+ href="https://sourceforge.net/p/refind/discussion/general/thread/5c7d0195/">this
+ forum thread</a> for a discussion of the topic.</li>
+
+<li>If you're using OS X and an Advanced Format disk, heed the warning that
+ <tt>install.sh</tt> displays and <i><b>do not</b></i> use <tt>bless
+ --info</tt> to check your installation status; this combination has
+ been reported to cause disk corruption on some Macs!</li>
+
+</ul>
+
+<p>In any event, you should peruse the script's output to ensure that everything looks OK. <tt>install.sh</tt> displays error messages when it encounters errors, such as if the ESP is mounted read-only or if you run out of disk space. You may need to correct such problems manually and re-run the script. In some cases you may need to fall back on manual installation, which gives you better control over details such as which partition to use for installation.</p>
+