vacuna 0.3.1

Simple web server for static files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59


### What is ?

Vacuna is a simple http[s] server for static files written in rust, with a simple configuration file in [KDL](https://kdl.dev/) language,
it's built where is possible using existing rust framework/libs, it uses actix-web for the server part with rustls for the ssl support, the configuration is handled
with knuffel.

### Getting started

#### Auto Configuration

A simple automatic configuration with acme-redirect managed certificates:

```kdl
server {
   listen "[::]:443" {
        ssl {
            acme-redirect "/var/lib/acme-redirect/live/"
        }
   } 
   auto "/var/www/"
}
```

This configuration will list all the folders in the `/var/www` and using the name of the folder as domain name and expose them as sites,
will also look for the certificates in the `/var/lib/acme-redirect/live/` sub folders and use them for ssl connections


#### Whole configuration

For the whole configuration check the `whole-conf.kdl` in the root of the repository


### Install

#### Deb

The repo already support to build a deb package, that included the whole configuration and a systemd unit, to build it just run

```sh
cargo deb
```

 
### Why ?

I just wanted a simple and modern static file server without the complexity of existing http servers (
that handle a big set of operation/modules/plugins/cgis/scripts ....) this server is born with the target
of serving static sites, only static sites!!

### What is the complexity?

This project aim to keep the complexity really low, try to use most of existing libs,
and contributing back to existing libs when needed and make sense.

### Where the name come from?

Vacuna is a ancient goddess of rest or job done read more of it on [wikipedia](https://en.wikipedia.org/wiki/Vacuna)