{"id":25310370,"url":"https://github.com/maxisam/mgob","last_synced_at":"2025-10-05T19:55:54.852Z","repository":{"id":59053022,"uuid":"527115382","full_name":"maxisam/mgob","owner":"maxisam","description":"MongoDB dockerized backup agent. Runs schedule backups with retention, S3 \u0026 SFTP upload, notifications, instrumentation with Prometheus and more.","archived":false,"fork":false,"pushed_at":"2025-09-26T04:09:11.000Z","size":5862,"stargazers_count":183,"open_issues_count":22,"forks_count":30,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-05T19:55:53.707Z","etag":null,"topics":["backup","docker","kubernetes","mongodb","s3-storage"],"latest_commit_sha":null,"homepage":"https://maxisam.github.io/mgob/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"stefanprodan/mgob","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxisam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["maxisam"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-08-21T05:34:59.000Z","updated_at":"2025-09-25T14:34:58.000Z","dependencies_parsed_at":"2023-10-01T16:45:29.257Z","dependency_job_id":"d9439462-0237-4544-85e1-b73feb98b385","html_url":"https://github.com/maxisam/mgob","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/maxisam/mgob","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisam%2Fmgob","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisam%2Fmgob/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisam%2Fmgob/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisam%2Fmgob/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxisam","download_url":"https://codeload.github.com/maxisam/mgob/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxisam%2Fmgob/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278510918,"owners_count":25998997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","docker","kubernetes","mongodb","s3-storage"],"created_at":"2025-02-13T13:54:46.843Z","updated_at":"2025-10-05T19:55:54.819Z","avatar_url":"https://github.com/maxisam.png","language":"Go","funding_links":["https://github.com/sponsors/maxisam"],"categories":[],"sub_categories":[],"readme":"# mgob\n\n[![Release](https://github.com/maxisam/mgob/actions/workflows/release.yml/badge.svg)](https://github.com/maxisam/mgob/actions/workflows/release.yml)\n[![Build Status](https://github.com/maxisam/mgob/actions/workflows/build.yml/badge.svg)](https://github.com/maxisam/mgob/actions/workflows/build.yml)\n[![Docker Pulls](https://img.shields.io/docker/pulls/maxisam/mgob)](https://hub.docker.com/r/maxisam/mgob/)\n[![GitHub release](https://img.shields.io/github/release/maxisam/mgob.svg)](https://GitHub.com/maxisam/mgob/releases/)\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/maxisam?label=Sponsor%20this%20project%20%E2%9D%A4%EF%B8%8F\u0026)](https://github.com/sponsors/maxisam)\n![GitHub](https://img.shields.io/github/license/maxisam/mgob)\n\n**MGOB** is a MongoDB backup automation tool designed using Go. This fork introduces a variety of enhancements over the original repository by [stefanprodan](https://github.com/stefanprodan/mgob), which is set to be archived. Check out the [archival discussion here](https://github.com/stefanprodan/mgob/issues/161).\n\n\u003e Note: New features are being added to this fork exclusively.\n\n## Enhancements in This Fork\n\n- Backup validation\n- Retry mechanism for backups\n- MS Team notification support\n- Updated email notification mechanism addressing the [certificate issue](https://github.com/stefanprodan/mgob/issues/160)\n- Go updated to 1.21\n- Dependencies updated\n- Introduced `warnOnly` option for all notification channels\n- Integrated Github Actions for CI/CD\n- New Helm Chart with enhanced metrics, liveness probe, and other features\n- Multiple Docker image releases catering to different backup solutions\n- Option to skip local backup when retention is set to 0 ([#42](https://github.com/maxisam/mgob/pull/42), Credit: @aneagoe)\n- On-demand restore API\n- Load config from environment variables to override config file. syntax: `PLAN_ID__KEY_PROPERTY` (e.g. `mongo_test__SMTP_SERVER=smtp.company.com`)\n\n### Helm Chart\n\n```bash\nhelm pull oci://registry-1.docker.io/maxisam/mgob --version 2.1.0\nhelm upgrade \u003cmy-release\u003e oci://registry-1.docker.io/maxisam/mgob --version \u003cnew-version\u003e\n```\n\n### Breaking Changes\n\n- v2: in config, sftp.private_key -\u003e sftp.privateKey\n\n## Original Features\n\n- schedule backups\n- local backups retention\n- upload to S3 Object Storage (Minio, AWS, Google Cloud, Azure)\n- upload to gcloud storage\n- upload to SFTP\n- upload to any [Rclone](https://rclone.org/) supported storage\n- notifications (Email, Slack)\n- instrumentation with Prometheus\n- http file server for local backups and logs\n- distributed as an Alpine Docker image\n\n## Installation\n\nMGOB is available on Docker Hub at [maxisam/mgob](https://hub.docker.com/r/maxisam/mgob).\n\nSupported tags:\n\n- `maxisam/mgob:latest` latest stable [release](https://github.com/maxisam/mgob/releases)\n\nCompatibility matrix:\n\n| MGOB                     | MongoDB |\n| ------------------------ | ------- |\n| `stefanprodan/mgob:0.9`  | 3.4     |\n| `stefanprodan/mgob:0.10` | 3.6     |\n| `stefanprodan/mgob:1.0`  | 4.0     |\n| `stefanprodan/mgob:1.1`  | 4.2     |\n| `maxisam/mgob:1.10`      | 5.0     |\n| `maxisam/mgob:1.12`      | 7.0     |\n\nDocker:\n\n```bash\ndocker run -dp 8090:8090 --name mgob \\\n    -v \"/mgob/config:/config\" \\\n    -v \"/mgob/storage:/storage\" \\\n    -v \"/mgob/tmp:/tmp\" \\\n    -v \"/mgob/data:/data\" \\\n    stefanprodan/mgob \\\n    -LogLevel=info\n```\n\n## Configuration\n\nDefine a backup plan (yaml format) for each database you want to backup inside the `config` dir.\nThe yaml file name is being used as the backup plan ID, no white spaces or special characters are allowed.\n\n[READ MORE](.document/BACKUP_PLAN.md)\n\n## On-Demand Operations\n\nMGOB exposes a set of HTTP endpoints for on-demand operations like backup, restore, status, metrics, and version.\n\nREAD MORE: [On-Demand Operations](.document/ON_DEMAND_OPERATION.md)\n\n## Logs\n\nREAD MORE: [Logs](.document/LOGS.md)\n\n## Metrics\n\nREAD MORE: [Metrics](.document/METRICS.md)\n\n## Restore\n\nREAD MORE: [Restore](.document/RESTORE.md)\n\n## Special Thanks\n\n- [stefanprodan](https://github.com/stefanprodan) for the original repository\n- [\u003cimg src=\".etc/deranged.svg\" width=\"45\" height=\"20\" /\u003e](https://github.com/derangeddk)\n  First awesome sponsor!!\n\n## Sponsors [![GitHub Sponsors](https://img.shields.io/github/sponsors/maxisam?label=Sponsor%20this%20project%20%E2%9D%A4%EF%B8%8F\u0026)](https://github.com/sponsors/maxisam)\n\n\u003c!-- sponsors --\u003e\u003c!-- sponsors --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxisam%2Fmgob","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxisam%2Fmgob","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxisam%2Fmgob/lists"}