.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "bup-ftp" "1" "2021-02-06" "Bup 0.32" ""
.hy
.SH NAME
.PP
bup-web - Start web server to browse bup repositiory
.SH SYNOPSIS
.PP
bup web [[hostname]:port]
.PP
bup web unix://path
.SH DESCRIPTION
.PP
\f[C]bup web\f[R] starts a web server that can browse bup repositories.
The file hierarchy is the same as that shown by \f[C]bup-fuse\f[R](1),
\f[C]bup-ls\f[R](1) and \f[C]bup-ftp\f[R](1).
.PP
\f[C]hostname\f[R] and \f[C]port\f[R] default to 127.0.0.1 and 8080,
respectively, and hence \f[C]bup web\f[R] will only offer up the web
server to locally running clients.
If you\[cq]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: \f[C]:8080\f[R].
.PP
When \f[C]unix://path\f[R] is specified, the server will listen on the
filesystem socket at \f[C]path\f[R] rather than a network socket.
.PP
A \f[C]SIGTERM\f[R] signal may be sent to the server to request an
orderly shutdown.
.SH OPTIONS
.TP
--human-readable
display human readable file sizes (i.e.\ 3.9K, 4.7M)
.TP
--browser
open the site in the default browser
.SH EXAMPLES
.IP
.nf
\f[C]
$ bup web
Serving HTTP on 127.0.0.1:8080...
\[ha]C
Interrupted.

$ bup web :8080
Serving HTTP on 0.0.0.0:8080...
\[ha]C
Interrupted.

$ bup web unix://socket &
Serving HTTP on filesystem socket \[aq]socket\[aq]
$ curl --unix-socket ./socket http://localhost/
$ fg
bup web unix://socket
\[ha]C
Interrupted.

$ bup web &
[1] 30980
Serving HTTP on 127.0.0.1:8080...
$ kill -s TERM 30980
Shutdown requested
$ wait 30980
$ echo $?
0
\f[R]
.fi
.SH SEE ALSO
.PP
\f[C]bup-fuse\f[R](1), \f[C]bup-ls\f[R](1), \f[C]bup-ftp\f[R](1),
\f[C]bup-restore\f[R](1), \f[C]kill\f[R](1)
.SH BUP
.PP
Part of the \f[C]bup\f[R](1) suite.
.SH AUTHORS
Joe Beda <jbeda@gmail.com>.