1 <?xml version='1.0' encoding='UTF-8' ?>
2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
4 <!-- $LastChangedRevision$ -->
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <manualpage metafile="index.xml.meta">
24 <parentdocument href="../"/>
26 <title>Frequently Asked Questions</title>
30 <p>This document is not a traditional FAQ, but rather a quick
31 guide showing you what to do when you run into problems with the
32 Apache HTTP Server.</p>
34 <p>A more traditional but quite outdated document is the <a
35 href="http://httpd.apache.org/docs/misc/FAQ.html">Apache 1.3
39 <section id="support.what2do">
40 <title>"Why can't I ...? Why won't ... work?" What to do in case of
43 <p>If you are having trouble with your Apache server software, you should
44 take the following steps:</p>
47 <dt>Check the ErrorLog!</dt>
48 <dd>Apache tries to be helpful when it encounters a problem. In many
49 cases, it will provide some details by writing one or more messages to the
50 server error log. Sometimes this is enough for you to diagnose and fix
51 the problem yourself (such as file permissions or the like). The default
52 location of the error log is
53 <code>/usr/local/apache2/logs/error_log</code>, but see the <directive
54 module="core">ErrorLog</directive> directive in your config files for the
55 location on your server.</dd>
57 <dt>Consult the wiki</dt>
58 <dd>The <a href="http://wiki.apache.org/httpd/">Apache HTTP
59 Server Wiki</a> contains guides to solving many common
62 <dt>Check the Apache bug database</dt> <dd>Most problems that
63 get reported to The Apache Group are recorded in the <a
64 href="http://httpd.apache.org/bug_report.html">bug database</a>.
65 <strong>Do not</strong> submit a new bug report until you have
66 checked existing reports (open <em>and</em> closed) and asked
67 about your problem in a user-support forum (see below). If you
68 find that your issue has already been reported, please
69 <em>don't</em> add a "me, too" report.</dd>
71 <dt><a id="support.what2do.user-support"
72 name="support.what2do.user-support">Ask in a user support forum</a></dt>
73 <dd><p>Apache has an active community of users who are willing to share
74 their knowledge. Participating in this community is usually the best and
75 fastest way to get answers to your questions and problems.</p>
77 <p><a href="http://httpd.apache.org/userslist.html">Users
80 <p><a href="irc://irc.freenode.net/#apache">#apache</a> on
81 <a href="http://freenode.net">Freenode IRC</a> is also available for
82 user support issues.</p>
85 <dt>Please use the bug database for bugs!</dt>
86 <dd><p>If you've gone through those steps above that are appropriate and
87 have obtained no relief, then please <em>do</em> let the httpd developers
88 know about the problem by <a
89 href="http://httpd.apache.org/bug_report.html">logging a bug
92 <p>If your problem involves the server crashing and generating a core
93 dump, please <a href="http://httpd.apache.org/dev/debugging.html">
94 include a backtrace</a> (if possible).</p>
99 <section id="support.support"><title>Whom do I contact for support?</title>
100 <p>With millions of users and fewer than sixty volunteer developers,
101 we cannot provide personal support for Apache. For free support, we
102 suggest participating in a user forum (see above).</p>
104 <p>Professional, commercial support for Apache is available from
105 a number of companies.</p>