baka/manpage.md

## NAME
baka \- do files and databases backup.

## SYNOPSIS
baka \[\-\-version | -V\] \[\-\-help | help\] \<command\> \[\<options\>...\]

## DESCRIPTION
baka allows you to backup MariaDB/MySQL and PostgreSQL directories and databases.

baka is based on handling entries. Processing can be started at once for everyone entries, either only for the selected ones, or for all but the excluded ones.

baka implements only the mechanism for creating archives with files and database dumps and transferring these files to remote storage using third-party tools (such as rsync, s3cmd). To perform scheduled backups, the command baka it is recommended to install it in the operating system task scheduler. For example cron. Examples of usage are in the section EXAMPLES.

From the above points and the possibility of customizing a separate entry, it follows that with using baka, you can configure the backup system quite flexibly.

**ATTENTION**: Despite the laudatory description above, baka should not be regarded as professional backup solutions. Please don't use baka in production-like environments.

### Basic concepts:

**Entry**

Entity describing the elements to be acted upon. There can be any number of these entities. For a more detailed description, see section CONFIGURATION FILES.

**Remote transport**

A method for delivering files to a remote storage. In version 0.1.0 it could be sync using rsync, upload files to S3 compatible storage with using the s3cmd utility or 'none', which means refusing to upload files to remote storage.

## COMMANDS

**backup**

Do backup right now. Available options:

    -i, --ignore=<entry>    run backup for all entries, except ignored.
    -e, --entry=<entry>     run backup for selected entry.
    --local                 force local backup.
    --no-verify             don't check archives integrity.
    --remove                remove old backups (forced).
    --help, help            print help message and exit.

**list**

List backup entries. Available options:

    -v, --verbose   print entries list verbosely (default).
    -s, --short     short format (names).
    -S              short format (pathes).
    --help, help    print help message and exit.

**test**

Test configuration incude all entries. Available options:

    -v, --verbose   print output verbosely.
    --help, help    print help message and exit.

**show**

Print main configuration.

**edit**

Edit main configuration in default text editor.

**remove**

Remove old local backups (older than $livetime days). Backup livetime is set in main.conf.

    -f, --force     force remove.
    --help, help    show this message and exit.

## CONFIGURATION FILES
### MAIN.CONF

Default path: /etc/baka/main.conf. This contains the values for the global baka settings.

Required parameters:

     log            log file (/var/log/baka).
     log_df         time format in the log. Example: %d %b %Y %T %z
                    More details in 'man date'.
     log_format     format of the log line. Has special syntax.
                    Example:
                        [%time] %log
                    Here:
                        %time   time formatted by 'log_df'.
                        %log    data string
     df             time format in file names. See 'man date'
     nf             file name format. Has special syntax.
                    Example:
                        %type_%name_%time
                    Here:
                        %type   content type. The archive name will be
                                added word 'dump' for database
                                or 'backup' for files.
                        %name   is the name of a directory or database.
                        %time   time formatted with 'df'.
     remote         remote transport.
     livetime       the lifetime of old backups (number of days).

Optional parameters:

    allow_commands  flag for executing commands from entries.
                    Default: Disabled
    ssh_uri         URI for SSH connection for rsync.
    ssh_port        specify port if different from standard 22.
    s3_uri          URI to connect to the S3 repository.
    local           local folder to save all backups. Everything
                    'dest' in entries will be ignored.

### ENTRIES

By default entries is stored into /etc/baka/entries/ directory in separated files. File name does not matter.

Here you can set the parameters for backuping the requred data set. See examples below.

**DESTINATION DIR**

This is this required parameter. It will be used if the `local` parameter is not specified in main.conf. You can specify it only once in an entry.

This is the only required parameter. And the only one that can be specified only once. In addition to the destination folder, at least one variable with data must be specified.

Example:

    dest = /home/user/backups

**FILES**

Files or directories to backup. Syntax:

    files = /path

Also you can do this:

    files = /path/1 path/2

You can add the `files` variable as many times as you like.

**EXCLUSIONS**

This parameter is in addition to the `files` parameter. With its help you can specify which files or folders should be excluded from the backup.

List files and folders separated by commas without spaces on one line:

    exclude = env,logs,__pycache__

Or split them into multiple lines:

    exclude = env
    exclude = logs
    exclude = __pycache__

**DATABASES**

baka can dump MariaDB/MySQL (shortcut 'mysql') and PostgreSQL (shortcut 'postgres') databases.

Syntax:

    [dmbs] = host:port:database:user:password

For example:

    postgres = localhost:5432:mydb:user:password

You can use shortened syntax too (use standart host and port):

    [dmbs] = host:database:user:password
    [dmbs] = database:user:password

**NOTE:** That due to the nature of the parser, colons and hash characters cannot be used in the database password.

**COMMANDS**

In addition to files and databases, baka can execute an arbitrary Bash command for you. For example:

    command = echo "Hello, World!"

This feature is disabled by default and must be added in the main config. DON'T USE UNTRUSTED COMMANDS IN ENTRY! This feature is pottentially dangerous. Make sure that access to the entries is restricted.

## EXAMPLES

An example of using baka. For example, there are two files in /etc/baka/entries/: example.org and example.com. Files content:

example.org:

    dest = /home/user/backups/example.org
    files = /srv/example.org/public
    exclude = logs, cache

example.com:

    dest = /home/user/backups/example.com
    files = /srv/example.org/public
    files = /srv/example.org/storage
    mysql = mydb: dbuser: password

In order to start backing up these sites at different times, let's add two tasks to crontab:

    00 00 * * *     /usr/bin/baka backup --entry=example.com
    00 00 */2 * *   /usr/bin/baka backup --entry=example.org

Likewise, you can start backing up more entries by adding exceptions or specifying specific entries. For example like this:

    baka backup --ignore=example.org --ignore=example.com

## BUGS
Report bugs to <gechandev@gmail.com> or <https://gitea.gch.icu/gd/baka>

## AUTHOR
gd (gechandev@gmail.com)