# TOML Configuration File
**`SWS`** can be configured using a [TOML](https://toml.io/en/) file in order to adjust the general server features as well as other advanced ones.
It's disabled by default and can be enabled by passing an *string file path* via the `-w, --config-file` option or its equivalent [SERVER_CONFIG_FILE](./../configuration/environment-variables.md#server_config_file) env.
## TOML File (Manifest)
Below just an example showing all features with its default values.
```toml
[general]
#### Address & Root dir
host = "::"
port = 80
root = "./public"
#### Logging
log-level = "error"
#### Cache Control headers
cache-control-headers = true
#### Auto Compression
compression = true
#### Error pages
page404 = "./public/404.html"
page50x = "./public/50x.html"
#### HTTP/2 + TLS
http2 = false
# http2-tls-cert = "some.cert"
# http2-tls-key = "some.key"
#### Security headers
security-headers = true
#### CORS
cors-allow-origins = ""
cors-allow-headers = ""
#### Directoy listing
directory-listing = false
directory-listing-order = 6
#### Basich Authentication
basic-auth = ""
#### File descriptor binding
# fd = ""
#### Worker threads
threads-multiplier = 1
#### Grace period after a graceful shutdown
grace-period = 0
#### Page fallback for 404s
# page-fallback = "some_page.html"
[advanced]
#### ....
```
### General options
The TOML `[general]` section allows to adjust the current options actually available via the CLI/ENVs ones.
So they are equivalent each other **except** the `-w, --config-file` option which is omitted and can not be used for obvious reasons.
!!! info "Config file based features are optional"
All server feature options via the configuration file are optional and can be omitted as needed.
### Advanced options
The TOML `[advanced]` section is intended for more complex features.
### Precendence
Whatever config file based feature option will take precedence over its CLI or ENV equivalent.
## Usage
The following command runs the server using an specific `config.toml` file.
```sh
static-web-server -w config.toml
```
