21ec5872f4
i found that most man pages only had references to the main git-annex manpage, which i stillfind pretty huge and hard to navigate through. i tried to sift through all the man pages and add cross-references between relevant pages. my general rule of thumb is that links should be both ways unless one of the pages is a more general page that would become ridiculously huge if all backlinks would be added (git-annex-preferred-content comes to mind). i have also make the links one per line as this is how it was done in the metadata pages so far. i did everything but the plumbing, utility and test commands, although some of those are linked from the other commands so cross-links were added there as well.
51 lines
1.2 KiB
Markdown
51 lines
1.2 KiB
Markdown
# NAME
|
|
|
|
git-annex webapp - launch webapp
|
|
|
|
# SYNOPSIS
|
|
|
|
git annex webapp
|
|
|
|
# DESCRIPTION
|
|
|
|
Opens a web app, that allows easy setup of a git-annex repository,
|
|
and control of the git-annex assistant. If the assistant is not
|
|
already running, it will be started.
|
|
|
|
By default, the webapp can only be accessed from localhost, and running
|
|
it opens a browser window.
|
|
|
|
# OPTIONS
|
|
|
|
* `--listen=address`
|
|
|
|
Useful for using the webapp on a remote computer. This makes the webapp
|
|
listen on the specified address.
|
|
|
|
This disables running a local web browser, and outputs the url you
|
|
can use to open the webapp.
|
|
|
|
Set annex.listen in the git config to make the webapp always
|
|
listen on an address.
|
|
|
|
# USING HTTPS
|
|
|
|
When using the webapp on a remote computer, you'll almost certainly
|
|
want to enable HTTPS. The webapp will use HTTPS if it finds
|
|
a .git/annex/privkey.pem and .git/annex/certificate.pem. Here's
|
|
one way to generate those files, using a self-signed certificate:
|
|
|
|
openssl genrsa -out .git/annex/privkey.pem 4096
|
|
openssl req -new -x509 -key .git/annex/privkey.pem > .git/annex/certificate.pem
|
|
|
|
# SEE ALSO
|
|
|
|
[[git-annex]](1)
|
|
|
|
[[git-annex-assistant]](1)
|
|
|
|
# AUTHOR
|
|
|
|
Joey Hess <id@joeyh.name>
|
|
|
|
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
|