8a63148ffdeb72d208289dd74ae9a3025dcaeae9
[asterisk/asterisk.git] / configs / http.conf.sample
1 ;
2 ; Asterisk Builtin mini-HTTP server
3 ;
4 ;
5 ; Note about Asterisk documentation:
6 ;   If Asterisk was installed from a tarball, then the HTML documentation should
7 ;   be installed in the static-http/docs directory which is
8 ;   (/var/lib/asterisk/static-http/docs) on linux by default.  If the Asterisk
9 ;   HTTP server is enabled in this file by setting the "enabled", "bindaddr",
10 ;   and "bindport" options, then you should be able to view the documentation
11 ;   remotely by browsing to:
12 ;       http://<server_ip>:<bindport>/static/docs/index.html
13 ;
14 [general]
15 ;
16 ; Whether HTTP/HTTPS interface is enabled or not.  Default is no.
17 ; This also affects manager/rawman/mxml access (see manager.conf)
18 ;
19 ;enabled=yes
20 ;
21 ; Address to bind to, both for HTTP and HTTPS. You MUST specify
22 ; a bindaddr in order for the HTTP server to run. There is no
23 ; default value.
24 ;
25 bindaddr=127.0.0.1
26 ;
27 ; Port to bind to for HTTP sessions (default is 8088)
28 ;
29 ;bindport=8088
30 ;
31 ; Prefix allows you to specify a prefix for all requests
32 ; to the server.  The default is blank.  If uncommented
33 ; all requests must begin with /asterisk
34 ;
35 ;prefix=asterisk
36 ;
37 ; sessionlimit specifies the maximum number of httpsessions that will be
38 ; allowed to exist at any given time. (default: 100)
39 ;
40 ;sessionlimit=100
41 ;
42 ; Whether Asterisk should serve static content from http-static
43 ; Default is no.
44 ;
45 ;enablestatic=yes
46 ;
47 ; Redirect one URI to another.  This is how you would set a
48 ; default page.
49 ;   Syntax: redirect=<from here> <to there>
50 ; For example, if you are using the Asterisk-gui,
51 ; it is convenient to enable the following redirect:
52 ;
53 ;redirect = / /static/config/index.html
54 ;
55 ; HTTPS support. In addition to enabled=yes, you need to
56 ; explicitly enable tls, define the port to use,
57 ; and have a certificate somewhere.
58 ;tlsenable=yes          ; enable tls - default no.
59 ;tlsbindport=4433       ; port to use - default is 8089
60 ;tlsbindaddr=0.0.0.0    ; address to bind to - default is bindaddr.
61 ;
62 ;tlscertfile=</path/to/certificate.pem>  ; path to the certificate file (*.pem) only.
63 ;tlsprivatekey=</path/to/private.pem>    ; path to private key file (*.pem) only.
64 ; If no path is given for tlscertfile or tlsprivatekey, default is to look in current
65 ; directory. If no tlsprivatekey is given, default is to search tlscertfile for private key.
66 ;
67 ; To produce a certificate you can e.g. use openssl. This places both the cert and
68 ; private in same .pem file.
69 ; openssl req -new -x509 -days 365 -nodes -out /tmp/foo.pem -keyout /tmp/foo.pem
70 ;
71 ; The post_mappings section maps URLs to real paths on the filesystem.  If a
72 ; POST is done from within an authenticated manager session to one of the
73 ; configured POST mappings, then any files in the POST will be placed in the
74 ; configured directory.
75 ;
76 ;[post_mappings]
77 ;
78 ; In this example, if the prefix option is set to "asterisk", then using the
79 ; POST URL: /asterisk/uploads will put files in /var/lib/asterisk/uploads/.
80 ;uploads = /var/lib/asterisk/uploads/
81 ;