NAME

partage.conf — partage configuration file format

DESCRIPTION

partage.conf is the configuration file for the HTTP file sharing system, partage(1).

CONFIGURATION

Here are the settings that can be set:

listen socket

Have the program listen on socket. This socket can be specified either as a TCP socket: host:port or as a Unix socket: /path/to/partage.sock. When using Unix sockets, the program will serve content using the FastCGI protocol.

user user

Username that the program will drop privileges to upon startup. When using Unix sockets, the owner of the socket will be changed to this user.

group group

Group that the program will drop privileges to upon startup (require that user is set). When using Unix sockets, the owner group of the socket will be changed to this group.

chroot dir

Directory to chroot into upon startup. When specified, all other path must be set within the chroot directory.

baseuri uri

Base URI to use when constructing hyper links.

rootdir dir

Directory containing static files.

tmplpath dir

Directory containing template files.

filepath dir

Directory where uploaded files must be written to.

metapath dir

Directory where metadata for uploaded files will be saved.

filectx context

URI context to use for serving files.

maxsize size

Maximum size per file to accept for uploads.

expiry time

Default expiration time to set for uploads.

EXAMPLE

Configuration suitable for use with httpd(8) using fastcgi:

listen      = /run/partage.sock
baseuri     = https://domain.tld
user        = www
group       = daemon
chroot      = /var/www
rootdir     = /htdocs/static
filepath    = /htdocs/files
metapath    = /htdocs/meta
tmplpath    = /htdocs/templates
filectx     = /d/
maxsize     = 10737418240 # 10 Gib
expiry      = 86400       # 24 hours

Mathing httpd.conf(5) configuration:

server "domain.tld" {
	listen on * tls port 443
	connection { max request body 10737418240 }
	location "*" {
		fastcgi socket "/run/partage.sock"
	}
}
types { include "/usr/share/misc/mime.types" }

SEE ALSO

partage(1), partage-trash(1), httpd(8,) httpd.conf(5)

AUTHORS

Willy Goiffon <dev@z3bra.org>