This page explains what files are generated by
hoard and where they can be found.
hoard uses the
config_dir and the
data_dir of the
The configuration directory holds the configuration file (
config.yml) as well as
other local-only configuration data.
The configuration file (
config.toml) contains the environment and hoard definitions, along
with all related configuration. Follow the link in the previous sentence for more about the
configuration file format.
The UUID file (
uuid) contains a unique identifier for the current system. This is used when performing
pre-operation checks. Files relating to this UUID are synchronized between machines using whatever
synchronization mechanism you use to synchronize hoards between machines, but nowhere else. This UUID
is not used to identify your machines to any service, only the
The hoard data directory contains all backed up hoard files, along with other files that should be synchronized with the hoard files.
All files backed up by
hoard are stored in the data directory, in a subdirectory called
The files are organized according to the names of the hoard and pile they are configured under.
As an example, consider the following real configuration:
[hoards.custom_fonts] "unix" = "/home/shadow53/.local/share/fonts" [hoards.fish] [hoards.fish.confdir] "unix" = "/home/shadow53/.config/fish/conf.d" [hoards.fish.functions] "unix" = "/home/shadow53/.config/fish/functions" [hoards.newsboat] "unix" = "/home/shadow53/.newsboat/config" [hoards.qemu] [hoards.qemu.script] "unix" = "/home/shadow53/.bin/vm" [hoards.qemu.configs] "unix" = "/home/shadow53/.config/qemu"
These hoards/piles are stored in the following locations:
$data_dir ├─ custom_fonts/ ├─ fish │ ├─ confdir/ │ └─ functions/ ├─ newsboat/ └─ qemu/ ├─ script └─ configs/
There are currently two types of history-related files stored by
hoard, both of which are used
in pre-operation consistency checks. All history-related files are stored in a subdirectory
in the data directory, where
uuid is the generated uuid of the current system.