docs/src/add-repository.md

Tue, 12 Dec 2017 17:41:01 +0100

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Tue, 12 Dec 2017 17:41:01 +0100
branch
v1.1
changeset 341
7954fdacdb5c
parent 283
0e36bb75a732
permissions
-rw-r--r--

enable va_list fix only on mingw (this is the real release, as usual)

---
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