bup-web man page

bup-web — Start web server to browse bup repositiory

Synopsis

bup web [[hostname]:port]

bup web unix://path

Description

bup web starts a web server that can browse bup repositories. The file hierarchy is the same as that shown by bup-fuse(1), bup-ls(1) and bup-ftp(1).

hostname and port default to 127.0.0.1 and 8080, respectively, and hence bup web will only offer up the web server to locally running clients. If you'd like to expose the web server to anyone on your network (dangerous!) you can omit the bind address to bind to all available interfaces: :8080.

When unix://path is specified, the server will listen on the filesystem socket at path rather than a network socket.

A SIGTERM signal may be sent to the server to request an orderly shutdown.

Options

--human-readable

display human readable file sizes (i.e. 3.9K, 4.7M)

--browser

open the site in the default browser

Examples

$ bup web
Serving HTTP on 127.0.0.1:8080...
^C
Interrupted.

$ bup web :8080
Serving HTTP on 0.0.0.0:8080...
^C
Interrupted.

$ bup web unix://socket &
Serving HTTP on filesystem socket 'socket'
$ curl --unix-socket ./socket http://localhost/
$ fg
bup web unix://socket
^C
Interrupted.

$ bup web &
[1] 30980
Serving HTTP on 127.0.0.1:8080...
$ kill -s TERM 30980
Shutdown requested
$ wait 30980
$ echo $?
0

See Also

bup-fuse(1), bup-ls(1), bup-ftp(1), bup-restore(1), kill(1)

Bup

Part of the bup(1) suite.

Authors

Joe Beda <jbeda@gmail.com>.

Referenced By

bup(1), bup-fuse(1), bup-restore(1), bup-tag(1).

2016-12-26 Bup 0.29