docs/src/add-repository.md

Sat, 28 Mar 2020 16:04:46 +0100

author
Mike Becker <universe@uap-core.de>
date
Sat, 28 Mar 2020 16:04:46 +0100
branch
feature/dav-edit
changeset 711
8d40b5ccc43e
parent 283
0e36bb75a732
permissions
-rw-r--r--

adds check for encryption key (otherwise segfault when trying to create a fresh encrypted file without a key)

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