docker-mongodb-backup

KO | EN

gitlite — search

#python #llm #svelte #html #machine-learning #ai #nextjs #csharp #github #telegram #deep-learning #css

docker-mongodb-backup

★ 31 Open GitHub ↗

Docker MongoDB Backup Container based on Alpine w/S6 init, Zabbix Monitoring

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# tiredofit/mongodb-backup
## Unmaintained - Active Development now resides here [tiredofit/db-backup](https://github.com/tiredofit/docker-db-backup)

# Introduction

This will build a container for backing up MongoDB containers.

* dump to local filesystem 
* select database user and password
* backup all databases or specific database
* choose to have an MD5 sum after backup for verification
* delete old backups after specific amount of time
* choose compression type (none, gz, bz, xz)
* connect to any container running on the same system
* select how often to run a dump
* select when to start the first dump, whether time of day or relative to container start time

This Container uses Alpine:Edge as a base.

[Changelog](CHANGELOG.md)

# Authors

- [Dave Conroy](https://github.com/tiredofit)

# Table of Contents

- [Introduction](#introduction)
    - [Changelog](CHANGELOG.md)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Configuration](#configuration)
    - [Data Volumes](#data-volumes)
    - [Environment Variables](#environmentvariables)   
- [Maintenance](#maintenance)
    - [Shell Access](#shell-access)

# Prerequisites

You must have a working MongoDB server available for this to work properly, it does not provide server functionality!

# Installation

Automated builds of the image are available on [Docker Hub](https://hub.docker.com/tiredofit/mongodb-backup) and is the recommended method of installation.

```bash
docker pull tiredofit/mongodb-backup
```

# Quick Start

* The quickest way to get started is using [docker-compose](https://docs.docker.com/compose/). See the examples folder for a working [docker-compose.yml](examples/docker-compose.yml) that can be modified for development or production use.

* Set various [environment variables](#environment-variables) to understand the capabiltiies of this image.
* Map [persistent storage](#data-volumes) for access to configuration and data files for backup.

> **NOTE**: If you are using this with a docker-compose file along with a seperate SQL container, take care not to set the variables to backup immediately, more so have it delay execution for a minute, otherwise you will get a failed first backup.

# Configuration

## Data-Volumes

The following directories are used for configuration and can be mapped for persistent storage.

| Directory | Description |
|-----------|-------------|
| `/backups` | SQL Backups |

## Environment Variables

Along with the Environment Variables from the [Base image](https://hub.docker.com/r/tiredofit/alpine), below is the complete list of available options that can be used to customize your installation.

| Parameter | Description |
|-----------|-------------|
|  `DB_HOST` | server name
|  `DB_NAME` | (optional) database name
|  `DB_USER` | (optional) username for the database
|  `DB_PASS` | (optional) password for the database
|  `DB_AUTH` | (optional) authentication database
|  `DB_DUMP_FREQ` | How often to do a dump, in minutes. Defaults to 1440 minutes, or once per day.
|  `DB_DUMP_BEGIN` | What time to do the first dump. Defaults to immediate. Must be in one of two formats
| | Absolute HHMM, e.g. `2330` or `0415`
| | Relative +MM, i.e. how many minutes after starting the container, e.g. `+0` (immediate), `+10` (in 10 minutes), or `+90` in an hour and a half
|  `DB_DUMP_DEBUG` | If set to `true`, print copious shell script messages to the container log. Otherwise only basic messages are printed.
|  `DB_DUMP_TARGET` | Where to put the dump file, should be a directory. Supports three formats |
| |  Local If the value of `DB_DUMP_TARGET` starts with a `/` character, will dump to a local path, which should be volume-mounted.
|  `DB_CLEANUP_TIME` | Value in minutes to delete old backups (only fired when dump freqency fires). 1440 would delete anything above 1 day old. You don't need to set this variable if you want to hold onto everything.
|  `COMPRESSION` | Use either Gzip (GZ), Bzip2 (BZ), XZip (XZ), or none (NONE). (Default GZ)
|  `MD5` | Generate MD5 Sum in Directory, TRUE or FALSE (Default TRUE)

## Maintenance
#### Shell Access

For debugging and maintenance purposes you may want access the containers shell.

```bash
docker exec -it (whatever your container name is e.g.) mongodb-backup bash
```

docker-mongodb-backup

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README