.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "bup-ftp" "1" "0.33.3" "Bup 0.33.3" ""
.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[V]bup web\f[R] starts a web server that can browse bup repositories.
The file hierarchy is the same as that shown by \f[V]bup-fuse\f[R](1),
\f[V]bup-ls\f[R](1) and \f[V]bup-ftp\f[R](1).
.PP
\f[V]hostname\f[R] and \f[V]port\f[R] default to 127.0.0.1 and 8080,
respectively, and hence \f[V]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[V]:8080\f[R].
.PP
When \f[V]unix://path\f[R] is specified, the server will listen on the
filesystem socket at \f[V]path\f[R] rather than a network socket.
.PP
A \f[V]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[V]bup-fuse\f[R](1), \f[V]bup-ls\f[R](1), \f[V]bup-ftp\f[R](1),
\f[V]bup-restore\f[R](1), \f[V]kill\f[R](1)
.SH BUP
.PP
Part of the \f[V]bup\f[R](1) suite.
.SH AUTHORS
Joe Beda <jbeda@gmail.com>.