https://github.com/level12/worek
A database backup tool
https://github.com/level12/worek
Last synced: 8 months ago
JSON representation
A database backup tool
- Host: GitHub
- URL: https://github.com/level12/worek
- Owner: level12
- License: other
- Created: 2018-10-08T15:17:44.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-02-01T16:10:09.000Z (over 5 years ago)
- Last Synced: 2025-09-15T23:21:14.248Z (9 months ago)
- Language: Python
- Size: 34.2 KB
- Stars: 0
- Watchers: 7
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: readme.rst
- Changelog: changelog.rst
- License: license.txt
Awesome Lists containing this project
README
Worek - A Database Backup Tool
##############################
.. image:: https://circleci.com/gh/level12/worek.svg?style=shield
:target: https://circleci.com/gh/level12/worek
.. image:: https://codecov.io/gh/level12/worek/branch/master/graph/badge.svg
:target: https://codecov.io/gh/level12/worek
Introduction
---------------
A logical database backup tool.
* Create full binary backups of a PostgreSQL database
* Restore a text or binary backup of a PostgreSQL database
* Can restore a database over the top of an existing database (clears all data
first) meaning you don't need a super user to restore a database.
Usage
--------------
Create a backup with the contents going to a file
.. code::
$ worek backup -d database_name -f ./backup.bin
Create a backup with the contents going to STDOUT
.. code::
$ worek backup -d database_name \
| openssl enc -aes-256-cbc -pass file:password.txt -md sha256 -d -out backup.bak.enc
Restore a backup from STDIN. Note you have to use the `-F` property to specify
the type of backup you are handing. This is not required when using `-f` and
specifying the file path.
.. code::
$ openssl enc -aes-256-cbc -pass file:password.txt -md sha256 -d -in backup.bak.enc \
| worek restore -h localhost -d database_name -F c
Supports standard `PG environment variables`
.. code::
$ PGPORT=5432 worek backup -d database_name -f ./backup.bin
Worek makes use of Postgres client utilities internally to create/restore backups.
If multiple versions of the utilities are present, by default Worek will attempt to match the
version of the utilities to the database server version. You may also specify a particular version
of the client utilities to use via the `--version` or `-v` option. This feature requires
`pg_wrapper` to be installed on the system.
.. code::
$ worek backup -d database_name -f ./backup.bin -v 11
.. _PG environment variables: https://www.postgresql.org/docs/current/libpq-envars.html