docs/src/add-repository.md

Wed, 20 Nov 2019 11:57:45 +0100

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Wed, 20 Nov 2019 11:57:45 +0100
changeset 681
3320429502cf
parent 283
0e36bb75a732
permissions
-rw-r--r--

fix some split bugs and add tests

---
title: 'dav add-repository'
---

This command runs an interactive assistant that creates a repository [configuration][1] and adds it to the config.xml file.

[1]: ./configuration.html

**Command alias:** add-repo

The assistant firstly asks for a unique repository name.
If you are not sure, which names are already in use, you can get a list of currently present repositories with [dav list-repositories][2].
Then you specifiy the base URL and optional authentication information.
Please keep in mind, that the password is stored base64 encoded in your configuration.
If you do not want this to happen, leave the password blank.
`dav` will ask you for the password when accessing the repository.
Beware that you don't use password prompt in background jobs, though.
A call of `add-repository` may look like this.

	$ dav add-repository
	Each repository must have an unique name.
	name: myfirstrepo

	Specify the repository base url.
	url: https://mynas.local/webdav

	User for HTTP authentication.
	user (optional): mywebuser
	password (optional): 

[2]: ./list-repositories.html

mercurial