path: root/english/support.wml

#use wml::debian::template title="Support"
#use wml::debian::toc

<define-tag toc-title-formatting endtag="required" whitespace="delete">
<h2>%body</h2>
</define-tag>

<toc-display />
<toc-add-entry name="doc" href="doc/">Documentation</toc-add-entry>

<p>Before searching for support from someone else, it's usually good to try
to find an answer to your problem yourself. That way you will usually get
the answers you need, and even if you don't, the experience of reading the
documentation will likely be useful for you in the future.</p>

<p>There is a fair amount of documentation available in Debian &mdash; please
refer to the <a href="doc/">Debian documentation</a> web page.</p>


<toc-add-entry name="release" href="releases/stable/">Known problems</toc-add-entry>

<p>Limitations and severe problems of the current stable distribution
(if any) are described on <a href="releases/stable/">the release pages</a>.</p>

<p>Pay particular attention to the <a href="releases/stable/releasenotes">release
notes</a> and the <a href="releases/stable/errata">errata</a>.</p>


<toc-add-entry name="wiki" href="https://wiki.debian.org/">Wiki</toc-add-entry>

<p>Solutions to common problems, howto's, guides, tips and other documentation
can be found at the <a href="https://wiki.debian.org/">Debian Wiki</a>.  Like
all wikis, this wiki is constantly changing and we welcome your edits.</p>


<toc-add-entry name="mail_lists" href="MailingLists/">Mailing lists</toc-add-entry>

<p>Debian is developed through distributed development all around
the world. Therefore e-mail is a preferred way to discuss various items.
Much of the conversation between Debian developers and users is managed
through several mailing lists.</p>

<p>There are several publicly available mailing lists. For more information,
see <a href="MailingLists/">Debian mailing lists</a> page.</p>

# Note to translators:
# You might want to adapt the following paragraph, stating which list
# is available for user support in your language instead of English.
<p>
For user support in English, please contact the 
<a href="https://lists.debian.org/debian-user/">debian-user
mailing list</a>.
</p>

<p>
For user support in other languages, please check the
<a href="https://lists.debian.org/users.html">mailing
lists index for users</a>.
</p>

<p>There are of course many other mailing lists, dedicated to some aspect
of the vast Linux ecosystem, which are not Debian-specific. Use your
favorite search engine to find the most suitable list for your purpose.</p>


<toc-add-entry name="usenet">Usenet newsgroups</toc-add-entry>

<p>A lot of our <a href="#mail_lists">mailing lists</a> can be browsed as
newsgroups, in the <kbd>linux.debian.*</kbd> hierarchy. This can also be
done using a web interface such as
<a href="http://groups.google.com/">Google Groups</a>.

<p>There are also a couple of proper newsgroups available that are related
to GNU/Linux. Despite the fact they're not specific to Debian, they can
still provide Debian users with a lot of information.</p>

<dl>

# translators are encouraged to add local Linux newsgroups here

<dt><a href="news:comp.os.linux.hardware">comp.os.linux.hardware</a></dt>
  <dd>Hardware-related discussions</dd>

<dt><a href="news:comp.os.linux.m68k">comp.os.linux.m68k</a></dt>
  <dd>About the Linux running on the Motorola 680x0 processor.</dd>

<dt><a href="news:comp.os.linux.setup">comp.os.linux.setup</a></dt>
  <dd>Setup and configuration of Linux systems</dd>

<dt><a href="news:comp.os.linux.networking">comp.os.linux.networking</a></dt>
  <dd>Networking related topics.</dd>

<dt><a href="news:comp.os.linux.x">comp.os.linux.x</a></dt>
  <dd>Using the X Window System on Linux computers</dd>

<dt><a href="news:comp.os.linux.misc">comp.os.linux.misc</a></dt>
  <dd>Miscellaneous topics. A catch-all group.</dd>
</dl>

<p>Please refer to
<a href="http://groups-beta.google.com/groups/dir?sel=33583540&amp;expand=1">this index</a>
for a more thorough list of related newsgroups.</p>


<toc-add-entry name="web">Web sites</toc-add-entry>

<h3>Forums</h3>

# Note to translators:
# If there is a specific Debian forum for your language you might want to
# insert here a paragraph stating which list is available for user support
# in your language and pointing to the English forums.
# <p><a href="http://someforum.example.org/">someforum</a> is a web portal
# on which you can use your language to discuss Debian-related topics,
# submit questions about Debian, and have them answered by other users.</p>
#
# <p><a href="http://forums.debian.net">Debian User Forums</a> is a web portal
# on which you can use the English language to discuss Debian-related topics,
# submit questions about Debian, and have them answered by other users.</p>

<p><a href="http://forums.debian.net">Debian User Forums</a> is a web portal on which
you can discuss Debian-related topics, submit questions about Debian, and have
them answered by other users.</p>

<h3>Other web resources</h3>

<p><a
href="https://www.debian-administration.org/">Debian-Administration.org</a>
provides tips and resources for Debian system administrators.</p>

<p>Helpful links about Unix:</p>

<ul>
  <li><a href="https://www.dmoztools.net/Computers/Software/Operating_Systems/Unix/">\
      Open Directory &mdash; Unix</a></li>
  <li><a href="https://unixpower.org/unixhelp/">UNIXhelp for users</a></li>
  <li><a href="http://personal.stevens.edu/~khockenb/comp-unix-admin.html">\
      comp.unix.admin FAQ</a></li>
</ul>


<toc-add-entry name="maintainers">Reaching Package Maintainers</toc-add-entry>

<p>There are two ways of reaching package maintainers. If you need to
contact the maintainer because of a bug, simply file a bug report (see the
Bug Tracking System section below). The maintainer will get a copy of the
bug report.</p>

<p>If you simply want to communicate with the maintainer, then you can use
the special mail aliases set up for each package. Any mail sent to
&lt;<em>package name</em>&gt;@packages.debian.org will be forwarded to the
maintainer responsible for that package.</p>


<toc-add-entry name="bts" href="Bugs/">The Bug Tracking System</toc-add-entry>

<p>The Debian distribution has a bug tracking system which
details bugs reported by users and developers.  Each bug is given a
number, and is kept on file until it is marked as having been dealt
with.</p>

<p>To report a bug, you can use one of the bug pages listed below, or you
can use the Debian package <q>reportbug</q> to automatically file a bug report.</p>

<p>Information on submitting bugs, viewing the currently active bugs, and
the bug tracking system in general can be found at the
<a href="Bugs/">bug tracking system web pages</a>.</p>


<toc-add-entry name="consultants" href="consultants/">Consultants</toc-add-entry>

<p>Debian is free software and offers free help through mailing lists. Some
people either don't have the time or have specialized needs and are willing
to hire someone to maintain or add additional functionality to their Debian
system.  See the <a href="consultants/">consultants page</a> for a list
of people/companies.</p>


<toc-add-entry name="irc">On-line Real Time Help Using IRC</toc-add-entry>

<p><a href="http://www.irchelp.org/">IRC (Internet Relay Chat)</a> is a way
to chat with people from all over the world in real time.
IRC channels dedicated to Debian can be found on
<a href="https://www.oftc.net/">OFTC</a>.</p>

<p>To connect, you need an IRC client. Some of the most popular clients are
<a href="https://packages.debian.org/stable/net/hexchat">HexChat</a>,
<a href="https://packages.debian.org/stable/net/ircii">ircII</a>,
<a href="https://packages.debian.org/stable/net/irssi">irssi</a>,
<a href="https://packages.debian.org/stable/net/epic5">epic5</a> and
<a href="https://packages.debian.org/stable/net/kvirc">KVIrc</a>,
all of which have been packaged for
Debian. OFTC also offers a <a href="https://www.oftc.net/WebChat/">WebChat</a>
web interface which allows you to connect to IRC with a browser without
the need to install any local client.</p>

<p>Once you have the client installed, you need to tell it to connect
to the server. In most clients, you can do that by typing:</p>

<pre>
/server irc.debian.org
</pre>

# Note to translators:
# You might want to insert here a paragraph stating which IRC channel is available
# for user support in your language and pointing to the English IRC channel.
# <p>Once you are connected, join channel <code>#debian-foo</code> by typing</p>
# <pre>/join #debian</pre>
# for support in your language.
# <p>For support in English, read on</p>

<p>Once you are connected, join channel <code>#debian</code> by typing</p>

<pre>
/join #debian
</pre>

<p>Note: clients like HexChat often have a different, graphical user interface
for joining servers/channels.</p>

<p>At this point you will find yourself among the friendly crowd of
<code>#debian</code> inhabitants. You're welcome to ask questions about
Debian there. You can find the channel's faq at 
<url "https://wiki.debian.org/DebianIRC" />.</p>


<p>There's a number of other IRC networks where you can chat about Debian,
too. One of the more prominent ones is the
<a href="http://freenode.net/">freenode IRC network</a> at
<kbd>chat.freenode.net</kbd>.</p>


<toc-add-entry name="other">Other support resources</toc-add-entry>

<p>Check the <a href="misc/related_links">related links</a>.</p>