gh-backup

Description

gh-backup is a Spring Boot tool for backing up public GitHub repositories for specified users or organizations. It is available as both a command-line tool and a web application.

Installation

First Time Installation

1. Ensure Java 17+ and Maven 3.6+ are installed.
2. Clone the repository:

   git clone https://github.com/dmccoystephenson/gh-backup.git
   cd gh-backup

3. Build the project:

   mvn clean package

4. The executable JAR will be created at target/gh-backup-1.0.0.jar.

Usage

Documentation

• User Guide – Getting started and common scenarios
• Commands Reference – Complete list of all CLI commands and options
• Configuration Guide – Detailed configuration options

Support

You can find the support Discord server here.

Experiencing a bug?

Please fill out a bug report here.

• Known Bugs

Contributing

• CONTRIBUTING.md

Testing

Unit Tests

Linux / macOS:

mvn clean test

Windows:

mvn clean test

If you see BUILD SUCCESS, the tests have passed.

Development

Building and Running Locally

1. Clone the repository and build:

   mvn clean package

2. Run in CLI mode:

   java -jar target/gh-backup-1.0.0.jar octocat

3. Run in web mode:

   java -Dspring.profiles.active=web -jar target/gh-backup-1.0.0.jar

   Then open http://localhost:8080 in your browser.

Authors and Acknowledgement

Developers

Name	Main Contributions
dmccoystephenson	Initial development and maintenance

License

This project is licensed under the MIT License.

You are free to use, modify, and distribute this software under the terms of the MIT License.

See the LICENSE file for the full license text.

Project Status

This project is in active development.

Changelog

See CHANGELOG.md for a release-by-release summary of changes.