aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorLeonard Kugis <leonard@kug.is>2025-10-06 15:41:15 +0200
committerLeonard Kugis <leonard@kug.is>2025-10-06 15:41:15 +0200
commit8070e3852d647ab64142402e2bf09cc5f719b244 (patch)
tree034776e96bd4f17f53ed847d53b4400d9540c5b8 /README.md
parentd0f9161188e70b1144db4739d97e20be872e06aa (diff)
downloadsquashr-master.tar.gz
Added READMEHEADmaster
Diffstat (limited to 'README.md')
-rw-r--r--README.md67
1 files changed, 67 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..548eea7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+# SquashR
+
+Manage backups based on SquashFS, OverlayFS and LUKS
+
+## Installation
+
+1. Clone this repository
+2.
+
+```bash
+make
+sudo make install
+```
+3. Adjust default config in `/etc/squashr.conf` or copy it to a custom directory.
+
+## Usage
+
+```
+Usage: squashr [OPTIONS] <COMMAND>
+
+Commands:
+ backup
+ minimize
+ new
+ mount
+ umount
+ delete
+ help Print this message or the help of the given subcommand(s)
+
+Options:
+ -c, --config <CONFIG>
+
+ --squashr-root <SQUASHR_ROOT>
+
+ --squashr-n-snapshots-min <SQUASHR_N_SNAPSHOTS_MIN>
+
+ --squashr-n-snapshots-max <SQUASHR_N_SNAPSHOTS_MAX>
+
+ --squashr-include <SQUASHR_INCLUDE>
+
+ --squashr-exclude <SQUASHR_EXCLUDE>
+
+ --squashr-truncate <SQUASHR_TRUNCATE>
+
+ --squashr-compression-enable <SQUASHR_COMPRESSION_ENABLE>
+ [possible values: true, false]
+ --squashr-compression-algo <SQUASHR_COMPRESSION_ALGO>
+
+ --squashr-compression-args <SQUASHR_COMPRESSION_ARGS>
+
+ --squashr-cryptsetup-enable <SQUASHR_CRYPTSETUP_ENABLE>
+ [possible values: true, false]
+ --squashr-cryptsetup-create-args <SQUASHR_CRYPTSETUP_CREATE_ARGS>
+
+ --squashr-cryptsetup-open-args <SQUASHR_CRYPTSETUP_OPEN_ARGS>
+
+ -h, --help
+ Print help
+ -V, --version
+ Print version
+```
+
+## References
+
+- [SquashFS](https://docs.kernel.org/filesystems/squashfs.html)
+- [OverlayFS](https://docs.kernel.org/filesystems/overlayfs.html)
+- [dm-crypt](https://docs.kernel.org/admin-guide/device-mapper/dm-crypt.html)