root/web/faq.php

<?php include 'HEADER.php'; ?>
<!-- HEADER ends -->

<div id="faq">
<h1>FAQ</h1>
  Here is a list of the most frequently asked questions:
<dl>
 <dt>How to compile it</dt>
 <dd><blockquote><pre class="shell">
 
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
make
 </pre></blockquote></dd>
 
 <dt>How to create dinamyc modules</dt>
 <dd><p>It's the default way.</p></dd>

 <dt>How to configure the module xyz to be linked statically</dt>
 <dd><blockquote><pre class="shell">

./configure --prefix=/usr --sysconfdir=/etc \
  --localstatedir=/var                      \
  --enable-static-module=xyz
 </pre></blockquote></dd>

 <dt>How to build everyhing statically</dt>
 <dd><blockquote><pre class="shell">

./configure --prefix=/usr --sysconfdir=/etc \
  --localstatedir=/var                      \
  --enable-static-module=all
 </pre></blockquote></dd>

 <dt>How to create a self signed certificate for TLS</dt>
 <dd><blockquote><pre class="shell">

openssl req -days 1000 -new -x509 -nodes    \
  -out /etc/cherokee/ssl/cherokee.pem       \
  -keyout /etc/cherokee/ssl/cherokee.pem
 </pre></blockquote></dd>

 <dt>How to compile it on Windows</dt>
 <dd><blockquote><pre class="shell">

./configure --prefix=/usr --sysconfdir=/etc  \
  --localstatedir=/var --enable-trace        \
  --enable-static-module=all --enable-static \
  --enable-shared=no --enable-beta
 </pre></blockquote></dd>

 <dt>How to cross compile the Win32 version</dt>
 <dd>
   From Linux: <a href="http://alobbs.com/news/1201">http://alobbs.com/news/1201</a><br />
   From MacOS: <a href="http://alobbs.com/news/1299">http://alobbs.com/news/1299</a>
 </dd>
 
 <dt>I'm trying to access cherokee-admin from a remote machine but it doesn't seem to work. Is it broken?</dt>
 <dd>No it is not. cherokee-admin binds only to local loopback by default. There are some workarounds:
 <ul>
 <li>Create an SSH tunnel. This is the recommended way. In order to do so you must issue the following command:
 <blockquote><pre class="shell">ssh -L 9090:localhost:9090 remote_IP</pre></blockquote>
 After that you can access the remote interface through http://localhost:9090 and every request will be forwarded to the remote IP running cherokee-admin.
 </li>
 <li>Launch cherokee-admin with the -a parameter in order to force it to listen to all the network interfaces.</li>
 <li>Finally you could always install cherokee on your local host, configure it there and then copy the generated cherokee.conf file to the device running the cherokee instance you wanted to set up.</li>
 </ul>
 </dd>
 
 <dt>I'm old-style and don't want to use your gorgeous configuration UI. Is there a way to replicate cherokee-admin's work by hand?</dt>
 <dd>
   Yes there is. The configuration file is a plain text file and its syntax is well documented. Check the documentation of your package, or its <a href="http://www.cherokee-project.com/doc/internal_configuration.html">online version</a>.<br/>
   Notice that it is not the recommended method, but the format will always be kept updated to facilitate scripting tasks, working with embedded devices and other similar situations.
 </dd> 

</dl>
</div>

<!-- FOOTER begins -->
<?php include 'FOOTER.php'; ?>