Add readme, license, install/remove script

This commit is contained in:
2025-10-28 21:25:47 +01:00
parent a0b97a856a
commit aa8851aca0
5 changed files with 228 additions and 1 deletions

74
README.md Normal file
View File

@@ -0,0 +1,74 @@
# mirror-sync
## Description
Seamless Mirror-Sync: Your Effortless Repository Synchronization Engine
Unlock true simplicity for keeping your mirrors aligned. Mirror-Sync is a clean, high-performance Go tool built to automate the replication of repositories with minimal fuss — no manual toil, no drift, no surprises.
### Why youll love it
- 📦 Plug-and-play: Drop the binary in, point it at your source & destination, configure via environment variables, and youre done.
- 🔁 Reliable mirroring: Whether youre syncing from one endpoint to another or maintaining multiple mirrors, Mirror-Sync keeps everything in step with precision.
- 🛠 Modern and lean: Written in Go with a minimal shell build wrapper, its designed for speed, simplicity and low-footprint deployment (Linux, containers, whatever you like).
In short
Mirror-Sync takes the headache out of repository mirroring. Set it up once, configure it easily, and forget about it — while knowing your mirrors stay consistent, aligned and up-to-date.
(Generated by AI because nobody will see it anyway)
## How to build
```sh
./build.sh --target-current
```
## How to install
```sh
./install.sh
```
### and uninstall
```sh
./uninstall.sh
```
## Make a project
- Step 1 : Make an empty directory
```sh
mkdir my-project
cd my-project
```
- Step 2 : Make a file named `git-compose.yaml`
```sh
nano git-compose.yaml
```
- Step 3 : Add the following content
```yaml
repositories:
my-repo:
storage:
source:
url: "https://git.example.com/user/repo"
mirror:
url: "https://github.com/user/repo"
authentication:
token: ""
schedule: "* * * * *"
```
- Step 4 : Apply the configuration
```sh
mirrorsync apply
```