1.\" $OpenBSD: httpd.8,v 1.53 2016/09/15 20:57:07 jmc Exp $ 2.\" 3.\" Copyright (c) 2014 Reyk Floeter <reyk@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: September 15 2016 $ 18.Dt HTTPD 8 19.Os 20.Sh NAME 21.Nm httpd 22.Nd HTTP daemon 23.Sh SYNOPSIS 24.Nm 25.Op Fl dnv 26.Op Fl D Ar macro Ns = Ns Ar value 27.Op Fl f Ar file 28.Sh DESCRIPTION 29The 30.Nm 31daemon is an HTTP server with FastCGI and TLS support. 32.Pp 33The FastCGI implementation has optional socket support. 34.Nm 35can log to 36.Xr syslog 3 37or per-server files with several standard formats. 38.Pp 39.Nm 40rereads its configuration file when it receives 41.Dv SIGHUP 42and reopens log files when it receives 43.Dv SIGUSR1 . 44.Pp 45The options are as follows: 46.Bl -tag -width Dssmacro=value 47.It Fl D Ar macro Ns = Ns Ar value 48Set a 49.Ar macro 50to a 51.Ar value . 52Macros can be referenced in the configuration files. 53.It Fl d 54Debug mode. 55Create one server and don't detach or become a daemon. 56This allows for easy monitoring of 57.Nm . 58.It Fl f Ar file 59Specifies the configuration file. 60The default is 61.Pa /etc/httpd.conf . 62.It Fl n 63Check that the configuration is valid, but don't start any servers. 64.It Fl v 65Verbose mode. 66Multiple 67.Fl v 68options increase the verbosity. 69.El 70.Sh FILES 71.Bl -tag -width "/etc/ssl/private/server.key" -compact 72.It Pa /etc/httpd.conf 73Default configuration file. 74.It Pa /etc/ssl/private/server.key 75Default SSL/TLS server key. 76.It Pa /etc/ssl/server.crt 77Default SSL/TLS server certificate. 78.It Pa /var/run/httpd.sock 79.Ux Ns -domain 80socket used for communication with 81.Nm . 82.It Pa /var/www/logs/access.log 83Default access log file. 84.It Pa /var/www/logs/error.log 85Default error log file. 86.El 87.Sh SEE ALSO 88.Xr acme-client 1 , 89.Xr httpd.conf 5 , 90.Xr slowcgi 8 91.Sh HISTORY 92The 93.Nm 94program first appeared in 95.Ox 5.6 . 96.Nm 97is based on 98.Xr relayd 8 . 99.Sh AUTHORS 100.An -nosplit 101The 102.Nm 103program was written by 104.An Reyk Floeter Aq Mt reyk@openbsd.org . 105