# Reference: scalws.yaml top level

URL: https://scalws.com/docs/reference/top-level/
Source: `docs/reference/schema` in the ScalWS repository

<h3 id="include"><code>include</code></h3>

| | |
|---|---|
| Syntax | `include: [<string>, ...]` |
| Default | `none` |
| Context | `scalws.yaml` |
| Reload | applies on reload |

Site files read in addition to this one (ADR-0048), e.g. `/etc/scalws/sites.d/*.yaml`: a path, or a directory plus a file pattern with one `*`; relative to this file's directory. Only the main file may include; the loader expands the sites into `tenants` and clears this list.


<h3 id="server"><code>server</code></h3>

| | |
|---|---|
| Syntax | `server: {...}` |
| Default | `required` |
| Context | `scalws.yaml` |
| Reload | applies on reload |

Server-wide settings: listeners, limits, TLS, cache, security, logging and the optional subsystems.


<h3 id="upstreams"><code>upstreams</code></h3>

| | |
|---|---|
| Syntax | `upstreams: {<key>: {...}, ...}` |
| Default | `none` |
| Context | `scalws.yaml` |
| Reload | applies on reload |

Named pools of upstream members (ADR-0049) used by `type: proxy` runtimes through `upstream: {pool: name}` or `backends`.