servus

A dead simple application to serve files and directories over HTTP.

Usage

Quick Local File Sharing

You can simply use the application in your terminal to serve files in your local network, for example if you want to share files from one device to another. Thats particularly useful because almost every modern device supports download via HTTP.

$ servus --serve ./data
[2022-11-08T18:20:53Z INFO  servus] Bound to address 172.17.0.3:80
[2022-11-08T18:20:53Z INFO  servus] LocalStore: ./data -> /

Let's assume you have a file calles big.file in the ./data directory. After starting servus, you can now download the file on another device by opening http://172.17.0.3/big.file in your browser.

Content Delivery Server

You can - of course - also set up servus as a small content delivery serivce. Therefore, you can simply use the provided Docker image.

/etc/servus/config.yml

address: "0.0.0.0:80"
stores:
  - type: "Local"
    directory: "/data"
    servepath: "data"

$ docker run \
    --name servus \
    --volume /var/opt/data:/data \
    --volume /etc/servus/config.yml:/etc/servus/config.yml:ro \
    ghcr.io/zekrotja/servus:latest \
        --config /etc/servus/config.yml

ToDo's

Some things I want to add in the future ot this project:

• Stats and Monitoring with Prometheus
• More store types like S3 buckets
• SSL support