# <a name="Getting_Your_GNU_Hurd_Running"> </a> Getting Your GNU/Hurd Running

This web is about the distribution of the software. Right now the [Debian GNU/Hurd](http://www.debian.org/ports/hurd/) distribution is the only organized distribution. However a non-Debian [GNU OS](http://hurd.gnu.org) distribution is being discussed, as well as a [Gentoo GNU/Hurd](http://forums.gentoo.org/viewtopic.php?t=41939&postdays=0&postorder=asc&start=0) one.

<form action="%SCRIPTURLPATH%/search%SCRIPTSUFFIX%/%WEB%/">
  <table>
    <tr>
      <td valign="top" width="65%">
        <p> %TOC% </p>
        <p><nop></nop></p>
        <h2><a name="General"> General </a></h2>
        <p>
        </p>
        <dl>
          <dt> Debian <a href="http://www.debian.org/ports/hurd/" target="_top">GNU/Hurd port</a></dt>
          <dd> Official page about the Debian distribution of the GNU/Hurd system. This is the only current distribution system available. </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><a href="http://lists.debian.org/debian-hurd/2002/debian-hurd-200210/msg00035.html" target="_top">Welcome Note</a></dt>
          <dd> Introduction to GNU and the Hurd sent monthly to <nop>Help-Hurd@gnu.org. </nop></dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><span style="background:"><font color="">Software Licensing</font></span><a href="http://LOCATION/SoftwareLicensing">?</a></dt>
          <dd> The copyright and license information for software that is distributed with the Hurd software is important. Debian has it's DFSG guidelines. Other distributions will need to address these same issues. </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt> Frequently Asked Questions</dt>
          <dd> The <a href="http://www.gnu.org/software/hurd/faq.en.html" target="_top">Hurd FAQ</a> is a key resource. <span style="background:"><font color="">New Questions</font></span><a href="http://LOCATION/NewQuestions">?</a> includes more questions and answers. A good document on how to ask good questions is <a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html" target="_top">ESR's Smart Questions</a>. </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><span style="background:"><font color="">Gnu Debian Relationship</font></span><a href="http://LOCATION/GnuDebianRelationship">?</a></dt>
          <dd> How does the GNU/Debian relationship work? </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><span style="background:"><font color="">Software Licensing</font></span><a href="http://LOCATION/SoftwareLicensing">?</a></dt>
          <dd> The copyright and license information for software that is distributed with the Hurd software is important. Debian has it's DFSG guidelines. Other distributions will need to address these same issues. </dd>
        </dl>
        <p>
        </p>
      </td>
      <td>
        <p>
        </p>
      </td>
      <td valign="top" width="35%">
        <p>
        </p>
        <table border="1" cellpadding="1" cellspacing="0">
          <tr>
            <th bgcolor="#99CCCC"><strong>Hot Topics <font size="-1">(<span style="background:"><font color="">more</font></span><a href="http://LOCATION/WebStatistics">?</a>)</font></strong></th>
            <th bgcolor="#99CCCC"><strong>Top Contributors</strong></th>
          </tr>
        </table> %INCLUDE{"WebStatistics" pattern=".*?\-\-statTopContributors\-\-\&amp;gt;[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+\|[^\|]+(\|[^\|]+\|[^\|]+\|).*"}% <p>
        </p><input name="search" size="20" type="text" /> <input type="submit" value="Search %WEB%" /><br /><font size="-1">More search options in <span style="background:"><font color="">Web Search</font></span><a href="http://LOCATION/WebSearch">?</a></font><br />
        <p> Currently, Web refers to the Distrib Web. </p>
        <p>
        </p>
        <p>
        </p>
        <ul>
          <li><span style="background:"><font color="">Web Index</font></span><a href="http://LOCATION/WebIndex">?</a> - alphabetical </li>
          <li><span style="background:"><font color="">Web Changes</font></span><a href="http://LOCATION/WebChanges">?</a> - by modification time </li>
          <li><span style="background:"><font color="">Web Notify</font></span><a href="http://LOCATION/WebNotify">?</a> - email alerts </li>
        </ul>
        <p>
        </p>
      </td>
    </tr>
  </table>
</form>

## <a name="Installation"> Installation </a>

<dl>
  <dt> Install Instructions</dt>
  <dd> Neal Walfield wrote a <a href="http://web.walfield.org/papers/hurd-installation-guide/english/hurd-install-guide.html" target="_top">step-by-step guide</a> that is the first document anyone installing Debian GNU/Hurd should read. <span style="background:"><font color="">Install Notes</font></span><a href="http://LOCATIONHurd/InstallNotes">?</a> is an errata companion document with more helpful hints that have not yet been incorporated. </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Cross Install</font></span><a href="http://LOCATION/CrossInstall">?</a></dt>
  <dd> Another way to install a system. </dd>
</dl>

<dl>
  <dt> Release Information</dt>
  <dd> About the latest CD release. Includes errata, known bugs and fixes. See <span style="background:"><font color="">CDNotes Home</font></span><a href="http://LOCATION/CDNotesHome">?</a> and <span style="background:"><font color="">Tarball Notes Home</font></span><a href="http://LOCATION/TarballNotesHome">?</a> for summaries </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Grub Notes</font></span><a href="http://LOCATION/GrubNotes">?</a></dt>
  <dd> A quick reference and explanation. There's also a topic for the new <span style="background:"><font color="">Grub Conf</font></span><a href="http://LOCATION/GrubConf">?</a>. </dd>
</dl>

Another installation method is using an emulated environment. The [[BochsEmulator]] is the recommended virtual machine solution.

* [[BochsFAQ]] - Common questions you should read.
* [[VmWare]] - Why using it is discouraged.

<dl>
  <dt> Debian Installer</dt>
  <dd> Work has been started by James Morrison and Glenn <nop>McGrath to <span style="background:"><font color="">Port Debootstrap</font></span><a href="http://LOCATION/PortDebootstrap">?</a>. There is also a <span style="background:"><font color="">New Debian Installer</font></span><a href="http://LOCATION/NewDebianInstaller">?</a>. Why should Hurd folks care? It's important because this is the next generation installer that is intended to be used by all ports when Sarge is released. </nop></dd>
</dl>

## <a name="For_nbsp_Developers"> For Developers </a>

<dl>
  <dt><span style="background:"><font color="">Savannah Projects</font></span><a href="http://LOCATION/SavannahProjects">?</a></dt>
  <dd> Savannah is a CVS &amp;amp; Bug system evolved from a free version of the code that powers <a href="http://sf.net" target="_top">sourceforge.net</a>. It has forked and been slightly modified for use by FSF, GNU and non-GNU projects. Actual Development takes place here. There is also a <a href="http://savannah.gnu.org/people/?group=hurd" target="_top">help wanted</a> list. </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Porting Issues</font></span><a href="http://LOCATION/PortingIssues">?</a> FAQ</dt>
  <dd> What does it take to move a piece of Debian packaged software to the GNU/Hurd port? </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Building The Hurd</font></span><a href="http://LOCATION/BuildingTheHurd">?</a></dt>
  <dd> A summary by the Gentoo folks, thanks <a href="http://cvs.gentoo.org/~avenj/" target="_top">Jon Portnoy</a> - <a href="mailto:avenj@gentooNOSPAM.org">avenj@gentooNOSPAM.org</a></dd>
</dl>

<dl>
  <dt> Debain Infrastructure</dt>
  <dd> Testing is critical in helping the development effort. Bugs (defect reports) can be filed against the Debian software package in which they are found. <span style="background:"><font color="">Bts Filing</font></span><a href="http://LOCATION/BtsFiling">?</a> tells how to file a Debian bug report. <span style="background:"><font color="">Debian Packages</font></span><a href="http://LOCATION/DebianPackages">?</a> has some information about how Debian splits the software into packages and some references. There is a buildd autobuilder compiling the Debian Sid archive software for the GNU/Hurd port. <span style="background:"><font color="">Buildd Status</font></span><a href="http://LOCATION/BuilddStatus">?</a> includes information on the buildd &amp;amp; turtle efforts. </dd>
</dl>

<dl>
  <dt> Technical References</dt>
  <dd> There are many standards and documents that might be applicable for those interested in developing software. </dd>
</dl>

* GNU [Coding Standards](http://www.gnu.org/prep/standards.html)
* [[TestSuites]] - Posix, Perl, results feedback, etc.
* [docs and papers](http://www.gnu.org/software/hurd/docs.html)
* [[SystemAPILimits]]
* [[Hurd/HurdSpecificGlibcApi]]
* [[CodeAnnouncements]] - Recent coding projects related to the Hurd

<dl>
  <dt> Debian <a href="http://www.debian.org/devel/" target="_top">Developer's Corner</a></dt>
  <dd> The following references are provided as a starting point for those interested in helping to package software for Debian GNU/Hurd and Debian GNU/Linux. </dd>
</dl>

* [Policy Manual](http://www.debian.org/doc/debian-policy/)
* Developer's [Reference](http://www.debian.org/doc/developers-reference/)
* New Maintainers [Guide](http://www.debian.org/doc/maint-guide/)
* There are many Debian email lists

<dl>
  <dt> Debian Todo</dt>
  <dd> Packages needing attention. A possible use of this site could be to help track similar needs via <span style="background:"><font color="">Hurd Wnpp</font></span><a href="http://LOCATION/HurdWnpp">?</a>. This is not yet implemented. </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Gnu Distribution Rumors</font></span><a href="http://LOCATION/GnuDistributionRumors">?</a></dt>
  <dd> There are some discussions and several rumors circulating about creating a completely new distribution, not using a Debian architecture. </dd>
</dl>

## <a name="Misc_"> Misc. </a>

<dl>
  <dt> Why a separate section of the website for this?</dt>
  <dd> There are fundamentally different issues about distributions compared with coding. Distributions are concerned with final default configurations of packaged software and system integration as they use many software packages and help give users a sense of using an OS "product." </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Why Debian</font></span><a href="http://LOCATION/WhyDebian">?</a></dt>
  <dd> A one page document focused on Debian aimed at users to answer their question "Why Debian?" </dd>
</dl>

<dl>
  <dt><span style="background:"><font color="">Debian Product Sheet</font></span><a href="http://LOCATION/DebianProductSheet">?</a></dt>
  <dd> Technical description of Debian aimed at those interested in Debian. </dd>
</dl>

* [Misc. Docs @Etherhogz](http://www.etherhogz.org/doc/) (broken)
* [Ognyan Kulev Collection](http://debian.fmi.uni-sofia.bg/~ogi/hurd/links/index.html) of links
* [2000 Jim Franklin Collection](http://angg.twu.net/the_hurd_links.html) of links

----

Meta discussions about the Distrib web goes in the [[WebDiscuss]] topic.

[[WebPreferences]] - administrative