blob: decf0e5f50c3955e5281205ca80d1f2cfe601705 (
plain)
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
|
# Vault
Vault is an opinionated web-based file manager. It is built in C for OpenBSD around the CGI standard, following these main principles:
* __secure__: a great amount of time has been devoted to avoid undefined behaviour and security issues
* __simple__: browse, create and delete folders; download and upload files. JavaScript support is optional on the client side and its absence should be handled gracefully. Everything should work from a terminal-based web browser
* __fast__: with the server running on an ARM SBC, there should not be any noticeable delay when loading a page
It should also compile and run on any POSIX OS with minor modifications, although this has not been tested (yet).
## Configure
The parameters and their documentation are in the `config.h` source file. You should read and adjust this file as needed before you build. The default config assumes a chrooted web server and sets a data directory `/vault-data` (that is `/var/www/vault-data` outside of the chroot).
## Build & run
Vault comes with a Makefile:
$ make
# make install
The vault binary will be installed as `/var/www/cgi-bin/vault`. You need to configure your web server accordingly. If the log file does not exist, you need to create it. Here is how to do it for a default installation:
# mkdir -p /var/www/var/log
# touch /var/www/var/log/vault.log
# chown www /var/www/var/log/vault.log
|