# <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 distribution is the only organized distribution. However a non-Debian GNU OS distribution is being discussed.

<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> About the Debian distribution of the GNU/Hurd system </dd>
        </dl>
        <p><a href="http://lists.debian.org/debian-hurd/2002/debian-hurd-200210/msg00035.html" target="_top">Welcome Note</a>: Introduction to GNU and the Hurd sent monthly to <nop>Help-Hurd@gnu.org. </nop></p>
        <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> How To</dt>
          <dd> Helpful hints and useful things to know when first trying out the Hurd </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">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>
        <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 <ul>
              <li><span style="background:"><font color="">Web Notify</font></span><a href="http://LOCATION/WebNotify">?</a> - email alerts </li>
            </ul>
          </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">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="">Grub Notes</font></span><a href="http://LOCATION/GrubNotes">?</a></dt>
  <dd> quick reference </dd>
</dl>

<dl>
  <dt> Release Information</dt>
  <dd> About the latest CD release (today the <span style="background:"><font color="">CDNotes K 1</font></span><a href="http://LOCATION/CDNotesK1">?</a> and <span style="background:"><font color="">Tarball Notes 20020816</font></span><a href="http://LOCATION/TarballNotes20020816">?</a>) 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>

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

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

<dl>
  <dt><span style="background:"><font color="">New Debian Installer</font></span><a href="http://LOCATION/NewDebianInstaller">?</a></dt>
  <dd> Why should Hurd folks care? </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> Debain Infrastructure</dt>
  <dd> Testing is critical in helping the development effort. Bugs 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 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)
* [[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/)

<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 seperate 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/)
* [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