.\" Automatically generated by Pandoc 3.5
.\"
.TH "bup\-ftp" "1" "2026\-01\-28" "Bup 0.33.10+"
.SH NAME
bup\-web \- Start web server to browse bup repositiory
.SH SYNOPSIS
bup web [[hostname]:port]
.PP
bup web unix://path
.SH DESCRIPTION
\f[CR]bup web\f[R] starts a web server that can browse bup repositories.
The file hierarchy is the same as that shown by \f[CR]bup\-fuse\f[R](1),
\f[CR]bup\-ls\f[R](1) and \f[CR]bup\-ftp\f[R](1).
.PP
\f[CR]hostname\f[R] and \f[CR]port\f[R] default to 127.0.0.1 and 8080,
respectively, and hence \f[CR]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[CR]:8080\f[R].
.PP
When \f[CR]unix://path\f[R] is specified, the server will listen on the
filesystem socket at \f[CR]path\f[R] rather than a network socket.
.PP
A \f[CR]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
.EX
$ 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
.EE
.SH SEE ALSO
\f[CR]bup\-fuse\f[R](1), \f[CR]bup\-ls\f[R](1), \f[CR]bup\-ftp\f[R](1),
\f[CR]bup\-restore\f[R](1), \f[CR]kill\f[R](1)
.SH BUP
Part of the \f[CR]bup\f[R](1) suite.
.SH AUTHORS
Joe Beda \c
.MT jbeda@gmail.com
.ME \c.