1
0
mirror of https://github.com/TheLocehiliosan/yadm synced 2024-10-27 20:34:27 +00:00
TheLocehiliosan_yadm/_docs/099_upgrade_from_2.md

35 lines
1.3 KiB
Markdown
Raw Normal View History

2020-12-28 02:56:37 +00:00
---
title: "Upgrading from Version 2"
permalink: /docs/upgrade_from_2
---
Beginning with version 3.0.0, yadm introduced a few major changes which may
require you to adjust your configurations.
## New name for yadm's encrypted archive
yadm now supports openssl in addition to gpg for encryption. Along with this
change, the encrypted archive is now called `archive` instead of the old name
`files.gpg`.
## New locations for data
yadm now uses the [XDG Base Directory Specification][xdg-spec] to find its data.
For the majority of users, this means data will now be in
`$HOME/.local/share/yadm/` instead of the old location of `$HOME/.config/yadm/`.
This location is used for the local repository and encrypted archive.
The easiest way to adopt these new paths is to use the `yadm upgrade` command.
This command will move your existing repo and encrypted archive to the new
directory. Upgrading will also re-initialize all submodules you have added
(otherwise they will be broken when the repo moves).
## Option `yadm.cygwin-copy` is no longer supported
Use the option `yadm.alt-copy` instead.
## Env variable `YADM_COMPATIBILITY=1` is no longer supported
Version 2 supported a version 1 compatibility mode, but this has been removed
from version 3.
[xdg-spec]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html