From d2ee0f07d3db0e707f16bbcb8abc3120dab10161 Mon Sep 17 00:00:00 2001 From: Mroik/PositiveC Date: Tue, 24 Jun 2025 10:50:04 +0200 Subject: Create README.md --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9af63c9 --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +# Orange Whale +Orange whale is a backup software that usage telegram as free storge. A docker image is available, just mount +the folders you want to backup and pass the folder names to `LOCATIONS` to tell Orange Whale what to upload. + +It requires you to also mount `/app/pub.txt`, a file containing your public PGP key. Yes it is required, and yes +it is useful, don't upload your personal data on external services without encrypting them. +Now the following envvar: +- `TELOXIDE_TOKEN`: is the telegram bot token you'll be using +- `CHAT_ID`: the group/channel your bot will upload to +- `LOCATIONS`: the folders to upload +- `INTERVAL`: how often to upload in hours. It takes an integer +- `RUST_LOG`: for logging stuff. If you're using it with docker I advise you to set it to `info` + +## Backups +Once the bot starts uploading you'll realize that the data is split in multiple parts. That's because bots on +telegram have an upload limit of 50MB on files. Just download all the parts and `cat` them together. After that +you can decrypt using your PGP key and unpack using tar. +```sh +cat part_* | gpg -d | tar x +``` -- cgit v1.2.3