2020-04-30 02:03:05 +00:00
|
|
|
---
|
|
|
|
layout: default
|
|
|
|
title: Server
|
|
|
|
parent: Configuration
|
2020-05-15 23:41:42 +00:00
|
|
|
nav_order: 7
|
2020-04-30 02:03:05 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Server
|
|
|
|
|
|
|
|
The server section configures and tunes the http server module Authelia uses.
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
# Configuration options specific to the internal http server
|
|
|
|
server:
|
|
|
|
# Buffers usually should be configured to be the same value.
|
|
|
|
# Explanation at https://docs.authelia.com/configuration/server.html
|
|
|
|
# Read buffer size configures the http server's maximum incoming request size in bytes.
|
|
|
|
read_buffer_size: 4096
|
|
|
|
# Write buffer size configures the http server's maximum outgoing response size in bytes.
|
|
|
|
write_buffer_size: 4096
|
2020-05-21 02:20:55 +00:00
|
|
|
# Set the single level path Authelia listens on, must be alphanumeric chars and should not contain any slashes.
|
|
|
|
path: ""
|
2020-04-30 02:03:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### Buffer Sizes
|
|
|
|
|
|
|
|
The read and write buffer sizes generally should be the same. This is because when Authelia verifies
|
|
|
|
if the user is authorized to visit a URL, it also sends back nearly the same size response
|
|
|
|
(write_buffer_size) as the request (read_buffer_size).
|
2020-05-21 02:20:55 +00:00
|
|
|
|
|
|
|
### Path
|
|
|
|
|
|
|
|
Authelia by default is served from the root `/` location, either via its own domain or subdomain.
|
|
|
|
|
|
|
|
Example: https://auth.example.com/, https://example.com/
|
|
|
|
```yaml
|
|
|
|
server:
|
|
|
|
path: ""
|
|
|
|
```
|
|
|
|
|
|
|
|
Modifying this setting will allow you to serve Authelia out from a specified base path. Please note
|
|
|
|
that currently only a single level path is supported meaning slashes are not allowed, and only
|
|
|
|
alphanumeric characters are supported.
|
|
|
|
|
|
|
|
Example: https://auth.example.com/authelia/, https://example.com/authelia/
|
|
|
|
```yaml
|
|
|
|
server:
|
|
|
|
path: authelia
|
|
|
|
```
|