| 1 |
== link:index.html[Index] -> link:config.html[Configuration] |
|---|
| 2 |
|
|---|
| 3 |
General Configuration |
|---|
| 4 |
--------------------- |
|---|
| 5 |
|
|---|
| 6 |
image::media/images/admin_general.png[General] |
|---|
| 7 |
|
|---|
| 8 |
|
|---|
| 9 |
[[networking]] |
|---|
| 10 |
Networking |
|---|
| 11 |
~~~~~~~~~~ |
|---|
| 12 |
|
|---|
| 13 |
Binding: |
|---|
| 14 |
^^^^^^^ |
|---|
| 15 |
When the server is initiated it opens a port and starts listening to |
|---|
| 16 |
incoming requests. By default this is port 80 and it will use all the |
|---|
| 17 |
network interfaces of the machine, which is usually the desired |
|---|
| 18 |
behavior. |
|---|
| 19 |
|
|---|
| 20 |
|
|---|
| 21 |
IPv6 support |
|---|
| 22 |
^^^^^^^^^^^^ |
|---|
| 23 |
The IPv6 configuration key brings the possibility of activating or |
|---|
| 24 |
deactivating the IPv6 support at the server. If Cherokee has been |
|---|
| 25 |
compiled with IPv6 support (--with-ipv6), this configuration entry |
|---|
| 26 |
will be fully functional, otherwise it will be ignored. |
|---|
| 27 |
|
|---|
| 28 |
|
|---|
| 29 |
Listen |
|---|
| 30 |
^^^^^^ |
|---|
| 31 |
This specifies the IP of the network interface to use. It can be left |
|---|
| 32 |
empty. |
|---|
| 33 |
|
|---|
| 34 |
|
|---|
| 35 |
[[basic_behavior]] |
|---|
| 36 |
Basic Behavior |
|---|
| 37 |
~~~~~~~~~~~~~~ |
|---|
| 38 |
|
|---|
| 39 |
Timeout |
|---|
| 40 |
^^^^^^^ |
|---|
| 41 |
Sets the number of seconds that Cherokee will wait before closing the |
|---|
| 42 |
connection. |
|---|
| 43 |
|
|---|
| 44 |
|
|---|
| 45 |
Server Tokens |
|---|
| 46 |
^^^^^^^^^^^^^ |
|---|
| 47 |
|
|---|
| 48 |
This specifies the string that Cherokee should use to identify |
|---|
| 49 |
itself. |
|---|
| 50 |
|
|---|
| 51 |
[grid="rows"] |
|---|
| 52 |
``~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 53 |
Parameters , Description |
|---|
| 54 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 55 |
Product , Cherokee |
|---|
| 56 |
Minor , Cherokee/0.11 |
|---|
| 57 |
Minimal , Cherokee/0.11.0 |
|---|
| 58 |
OS , Cherokee/0.11.0 (UNIX) |
|---|
| 59 |
Full , Cherokee/0.11.0 b2321 (UNIX) |
|---|
| 60 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 61 |
|
|---|
| 62 |
By default, Cherokee will use *Full*. |
|---|
| 63 |
|
|---|
| 64 |
|
|---|
| 65 |
|
|---|
| 66 |
[[server_permissions]] |
|---|
| 67 |
Server Permissions |
|---|
| 68 |
~~~~~~~~~~~~~~~~~~ |
|---|
| 69 |
|
|---|
| 70 |
User & Group |
|---|
| 71 |
^^^^^^^^^^^^ |
|---|
| 72 |
|
|---|
| 73 |
The User directive configures which user the Cherokee daemon will |
|---|
| 74 |
normally run as. By default, Cherokee runs as root which is considered |
|---|
| 75 |
undesirable in all but the most trustful network configurations. |
|---|
| 76 |
|
|---|
| 77 |
The User directive used in conjunction with the Group directive |
|---|
| 78 |
instructs the daemon to switch to the specified user and group as |
|---|
| 79 |
quickly as possible after startup. |
|---|
| 80 |
|
|---|
| 81 |
There are two possible formats: using the user or group name, or using |
|---|
| 82 |
the system ID. |
|---|
| 83 |
|
|---|
| 84 |
Chroot |
|---|
| 85 |
^^^^^^ |
|---|
| 86 |
|
|---|
| 87 |
Cherokee can be jailed inside a directory. Note that this should not |
|---|
| 88 |
be used as the sole security measure. |
|---|
| 89 |
|
|---|
| 90 |
|
|---|
| 91 |
[[secure_http]] |
|---|
| 92 |
Secure HTTP |
|---|
| 93 |
~~~~~~~~~~~ |
|---|
| 94 |
|
|---|
| 95 |
Port TLS |
|---|
| 96 |
^^^^^^^^ |
|---|
| 97 |
The *Port TLS* specifies the port to be used for secure connections. |
|---|
| 98 |
|
|---|
| 99 |
Back-end |
|---|
| 100 |
^^^^^^^^ |
|---|
| 101 |
Specifies the TLS/SSL backend to be used, if any. The current option |
|---|
| 102 |
is OpenSSL. |
|---|