https://github.com/jonathas/mongo-s3-backup

A script to backup your MongoDB databases to Amazon S3
https://github.com/jonathas/mongo-s3-backup

aws aws-s3 backup cron docker mongodb typescript

Last synced: 3 months ago
JSON representation

A script to backup your MongoDB databases to Amazon S3

• Host: GitHub
• URL: https://github.com/jonathas/mongo-s3-backup
• Owner: jonathas
• License: gpl-3.0
• Created: 2016-11-08T19:26:32.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-07-27T13:42:27.000Z (almost 9 years ago)
• Last Synced: 2025-03-06T12:16:37.432Z (over 1 year ago)
• Topics: aws, aws-s3, backup, cron, docker, mongodb, typescript
• Language: TypeScript
• Size: 72.3 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mongo S3 Backup

[![Build Status](https://travis-ci.org/jonathas/mongo-s3-backup.svg?branch=master)](https://travis-ci.org/jonathas/mongo-s3-backup) [![Coverage Status](https://coveralls.io/repos/github/jonathas/mongo-s3-backup/badge.svg?branch=master)](https://coveralls.io/github/jonathas/mongo-s3-backup?branch=master)

A script to backup your MongoDB databases and store them on Amazon S3.

It generates a dump from your MongoDB databases, compresses this dump as tar.bz2, generates a hash file for integrity check and then uploads both files to your Amazon S3 bucket.

In order to test it, be sure to have the following dependencies installed on your system:

- MongoDB installed and running

- [yarn](https://yarnpkg.com/)

- [docker](https://www.docker.com)

- [docker-compose](https://docs.docker.com/compose/install/)

Before running anything, please configure your AWS credentials inside the .env file.

You can run the backup script directly on your system and [configure cron by yourself](https://corenominal.org/2016/05/12/howto-setup-a-crontab-file/) or use the Docker config provided. 

In order to start the Docker container and configure cron inside of it to run the script every day at 00:00 CET, run:

```

$ make

```

In order to start this container automatically if your server reboots:

- Change the path inside the file infra/host/etc/systemd/system/mongo-backup.service to be the path where you put the mongo-s3-backup source code.

- As root, copy this file to /etc/systemd/system in your server

- Enable and start it:

```

# systemctl enable mongo-backup

# systemctl start mongo-backup

```

If you don't want to use Docker, just run instead:

```

$ make no-docker

```

And then configure the script directly on your system's cron.