docs/src/add-repository.md

Fri, 01 Jun 2018 08:52:05 +0200

author
Olaf Wintermann <olaf.wintermann@gmail.com>
date
Fri, 01 Jun 2018 08:52:05 +0200
changeset 399
a985a587787f
parent 283
0e36bb75a732
permissions
-rw-r--r--

fixes header include order (dav-sync)

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