Changes

{{languages|How to make a backup}} '''How to make a backup''' of your Gramps genealogy Family Tree database. ==Gramps version 3.3 and later== From the menu simply select {{man menu|Family Trees > Make Backup..."}} The {{man label|Gramps XML Backup}} window will appear. [[Image:MakeBackup-GrampsXMLBackup-40.png|right|thumb|450px|Fig. 1. Backup Options]] You can enter the path where the backup should be stored manually or using the path selector button.  You can enter a file name manually or use the automatically generated file name. You can either choose to '''Include'''(default) or ''Exclude'' the {{man label|Media:}}.  {{man note|Note|This is just a regular XML export, except that no data is filtered out. You can import these as usual with any exported file.}}

===Advanced settings=== You can also define the pattern for the backup filename by setting the ''paths.quick-backup-filename'' in the ~/.gramps/gramps42/gramps.ini key file like the following:{{-}} [paths] quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s' You can use any of the following keywords in the pattern:*filename*year*month*day*hour*minutes*seconds*extension :**'''.gpkg'''(default) if you include media.**''.gramps'' if you exclude media. Use the appropriate ~/.gramps/gramps{languages|How XX}/gramps.ini key file.*Gramps version 4.2 : ~/.gramps/gramps42/gramps.ini ==Gramps version 3.1.x to make 3.2.x == ===With media files===Assuming your database is called "My Family Tree", and you want the backup to include external media objects such as images and documents, the recommended method to create a backup}}is to use the gramps-pkg format:  gramps -O "My Family Tree" -e backup.gpkg or  gramps --open="My Family Tree" --export=backup.gpkg

==GRAMPS version 2.2In case of problems, you can add the format of the output to the above command.xFor a gramps package: --format=gpkgor --format=gramps-pkg

The gramps-xml data format will produce a backup of your data excluding any If you don't need to include the media objectsin your backup, such as external images and documents. The following example shows how to create a gramps-xml file from a database called "MyFamilyTree.grdb"then you can make use of the [[Gramps XML]] format:

gramps -O MyFamilyTree"My Family Tree" -e backup.grdb gramps  or  gramps -o -open="My Family Tree" --export=backup.gramps  This is equivalent to selecting the following menu options {{man menu|Family Trees -> Export -f gramps> "Gramps XML database" -xml> "Entire Database"}}

==GRAMPS version 3The [[Generate XML]] page has further information on what can be done with the .gramps files.x==

If you don't need to include the media objects in your backup, then you can make use of the [[GRAMPS Gramps XML|gramps-xml]] format:

==Gramps version 2.2.x== ===Without media files===The gramps-xml data format will produce a backup of your data excluding any media objects, such as external images and documents. The following example shows how to create a gramps-xml file from a database called "<code>MyFamilyTree.grdb</code>":  gramps -O MyFamilyTree.grdb -o backup.gramps -f gramps-xml ==GEDCOM export==={{man warn|GEDCOM export|Please note that GEDCOM is not recommended for backups since it is a [[Gramps_and_GEDCOM|lossy format]]. But there }} There are times you may need to export your data to GEDCOM. This command will attempt to export your database as a GEDCOM file: