Sporadic efforts by numerous individuals have been made to keep the information in this wiki current. The hope that the primary development team would make this a canonical source has not been fulfilled. While some of the information and links here are still valid, unfortunately much is not.

-- [[Main/GrantBow]] - 24 Jul 2007

Jon: We need a better logo for this page - ever since the Gentoo and Bee movements got involved I've been thingking about fixing this logo, but I haven't had any time. Suggestions, gfx donations? -- [[Main/JoachimNilsson]] - 30 Jun 2004

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

This web is about the distribution of software: where and how to get it.

<form action="%SCRIPTURLPATH%/search%SCRIPTSUFFIX%/%WEB%/">
  <table>
    <tr>
      <td valign="top" width="65%">
        <p> %TOC% </p>
        <p><nop></nop></p>
        <h2><a name="Distributions"> Distributions </a></h2>
        <p><nop></nop></p>
        <h3><a name="Debian_nbsp_http_www_debian_org_"> </a> Debian <a href="http://www.debian.org/ports/hurd/" target="_top">GNU/Hurd port</a>: </h3>
        <p> Official page about the Debian distribution of the GNU/Hurd system. Some additional notes are at <span style="background:"><font color="">Debian Status</font></span><a href="http://LOCATION/DebianStatus">?</a>. </p>
        <ul>
          <li><a href="http://people.debian.org/~mbanck/talks/hurd_lt2004/html/" target="_top">Presentation "Debian GNU/Hurd" by Michael Banck, <nop>LinuxTag 2004 Karlsruhe</nop></a></li>
        </ul>
        <p>
        </p>
        <ul>
          <li><a href="http://www.numenor.art.pl/balrog/hurd/" target="_top">A disk image with an installation of the Debian distribution of GNU/Hurd</a></li>
        </ul>
        <p>
        </p>
        <ul>
          <li><span style="background:"><font color="">Debian FAQ</font></span><a href="http://LOCATION/DebianFAQ">?</a></li>
        </ul>
        <p>
        </p>
        <ul>
          <li><span style="background:"><font color="">Debian After Install</font></span><a href="http://LOCATION/DebianAfterInstall">?</a> -- Do this to get networking, new console and X </li>
        </ul>
        <p>
        </p>
        <dl>
          <dt><a href="http://hurd.rustedhalo.net/" target="_top">Gentoo-Hurd</a></dt>
          <dd> Unofficial port to Gentoo &amp;amp; the portage system. It was <a href="http://forums.gentoo.org/viewtopic.php?t=41939&amp;postdays=0&amp;postorder=asc&amp;start=0" target="_top">announced</a> March 17, 2003 in the Gentoo forums. There's a #gentoo-irc channel similar to <span style="background:"><font color="">Hurd IRC</font></span><a href="http://LOCATIONHurd/HurdIRC">?</a>. At present (May 2005), there's no activity and Eric Olinger has not the time to maintain this distri. </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><a href="http://bee.es.gnu.org/" target="_top">Bee GNU/Hurd</a></dt>
          <dd> Castellano distribution, pkgsrc package based. <span style="background:"><font color="">Bochs Emulator</font></span><a href="http://LOCATION/BochsEmulator">?</a> image available too. They have their own <a href="http://es.gnu.org/cgi-bin/beewiki.pl?Wiki_Bee_GNU" target="_top">wiki</a> and a <a href="http://bee.es.gnu.org/?p=mail&amp;l=en" target="_top">mail list</a> (no archive). </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt> Some ISOs</dt>
          <dd><a href="http://www.gnuab.org/qui-som" target="_top">GNUAB</a> has some images and packages available at <a href="http://ftp.gnuab.org" target="_top">http://ftp.gnuab.org</a> for the unreleased (not unstable) Debian distro </dd>
        </dl>
        <p>
        </p>
        <dl>
          <dt><span style="background:"><font color="">Gnu OS</font></span><a href="http://LOCATION/GnuOS">?</a></dt>
          <dd> distribution is in discussion &amp;amp; pre-planning phase </dd>
        </dl>
        <p><nop></nop></p>
        <h2><a name="General"> General </a></h2>
        <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><span style="background:"><font color="">Frequently Asked Questions</font></span><a href="http://LOCATION/FrequentlyAskedQuestions">?</a></dt>
          <dd> It's good to read it before asking questions. </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> Currently, <a href="http://www.debian.org/ports/hurd/hurd-install" target="_top">Debian's installation instructions</a> are the most up-to-date. <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>

<dl>
  <dt><span style="background:"><font color="">Install Tips</font></span><a href="http://LOCATION/InstallTips">?</a></dt>
  <dd> Info on how to install without a cd drive or linux installed as well as a few tips. </dd>
</dl>

Another installation method is using an emulated environment. The [[BochsEmulator]] was originally the recommended virtual machine solution, however most have switched over to QEMU, as it runs faster.

* [[HurdOnQEMU]] - A guide on how to use QEMU to run the hurd.
* [[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="Using_the_system"> Using the system </a>

[[DebianAfterInstall]] instructions are a must-read to prepare an usable system.

[[PackageTroubleshooting]] reports known bugs, quirks and workarounds about getting applications to work (if possible).

## <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><a href="http://hurd.she.kicks-ass.org:8084/uninstallable/" target="_top">Uninstallable packages</a></dt>
  <dd> Many packages depend on these uninstallable packages. So building one of them will allow other to be build too. </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 (unsupported)
* [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