bit-backup/README.md

181 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

2024-05-01 11:31:00 +02:00
# bit-backup
2023-07-30 11:44:44 +02:00
2024-05-21 20:48:30 +02:00
You can find more information in docs directory.
2023-09-28 19:22:47 +02:00
### Feature 2 : Backup of files
2023-11-05 11:35:03 +01:00
2024-05-08 18:32:35 +02:00
#### File .bitbackup/bitbackuplog
2023-09-28 19:22:47 +02:00
2024-05-08 18:32:35 +02:00
Contains index number of last bitbackup index.
2023-09-28 19:22:47 +02:00
2024-05-08 18:32:35 +02:00
#### file .bitbackup/description
2023-09-28 19:22:47 +02:00
2024-05-08 18:32:35 +02:00
#### File .bitbackup/config
2023-09-28 19:22:47 +02:00
```
pack-file.files-until-size.mb=100
pack-file.max-size.mb=1000
```
## Commands
2024-05-08 18:32:35 +02:00
bitbackup {command} [{arg1} {arg2} {argn}]
2023-09-28 19:22:47 +02:00
Example:
```
2024-05-08 18:32:35 +02:00
bitbackup clone path=/home/johndoe/mydir url={local path or s3 bucket or FTP server or website url}
2023-09-28 19:22:47 +02:00
```
Arguments
path={path to directory}
* default:. (current working directory)
### bitrot
Checks for bitrots in current directory
### clone : Cloning a remote repo
```
2024-05-08 18:32:35 +02:00
bitbackup clone {url} [[--bare]] [[revision number|tag]]
2023-09-28 19:22:47 +02:00
```
#### Local
```
2024-05-08 18:32:35 +02:00
bitbackup clone {path to another local Bit Backup repository - path to directory}
```
#### S3
```
2024-05-08 18:32:35 +02:00
bitbackup clone s3://http[s]://{endpoint url}/{bucket name}
```
Then you will be asked for access key and secret key.
#### FTP/FTPS/SFTP
```
2024-05-08 18:32:35 +02:00
bitbackup clone {protocol}://[{user}:{password}]@{host url}:{port}/{directory}
```
#### HTTP/HTTPS
```
2024-05-08 18:32:35 +02:00
bitbackup clone http[s]://[{user}:{password}]@{host url}:{port}/{directory}
```
2024-05-08 18:32:35 +02:00
#### Bit Backup server (via Rest api)
```
2024-05-08 18:32:35 +02:00
bitbackup clone bitbackup:://[{user}:{password}]@{host url}:{port}/[path to repository/]{repository name}
```
2023-09-28 19:22:47 +02:00
### init
2024-05-08 18:32:35 +02:00
Init commands creates new directory .bitbackup with its structure
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup init [[--bare]]
```
2024-05-08 18:32:35 +02:00
* Creating a new empty Bit Backup repository
* Creating a Bit Backup repository using an existing directory
### help
### version
### config
### restore
### reset
### tag
### revert
### blame
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup blame {file} {remote}
2023-11-05 11:35:03 +01:00
```
### clean
### gc
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup gc abc
2023-11-05 11:35:03 +01:00
```
### fsck
### check
### bundle
### remote add {remote name}
2023-07-30 12:15:51 +02:00
```
2024-05-08 18:32:35 +02:00
bitbackup remote add {remote name}
```
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup remote add abc protocol://user:pw|{}@host:port/directory[::password=encryption_password|{}::duplicate_count=1::exclude=::include=::]
bitbackup remote add wedos_disk_100gb_backup user:pw@host:port/directory::password=123::duplicate_count=2
bitbackup remote add abc user:pw|{}@host:port/directory::password=encryption_password|{}::duplicate_count={1, 0 is default}::compression_level={0-9,5 is default}
2023-11-05 11:35:03 +01:00
```
{} placeholders means, that user will be asked in console (to avoid the password to be in console history)
### remote remove {remote name}
```
2024-05-08 18:32:35 +02:00
bitbackup remote remove abc
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
### bitbackup commit
```
2024-05-08 18:32:35 +02:00
bitbackup commit [-m "{message}"]
```
2024-05-08 18:32:35 +02:00
### bitbackup mirror {remote name}
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup mirror abc def ghi [-m message -t TAG]
bitbackup mirror @all
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
### bitbackup fetch
2024-05-08 18:32:35 +02:00
### bitbackup pull
2024-05-08 18:32:35 +02:00
### bitbackup log
2024-05-08 18:32:35 +02:00
### bitbackup diff
2024-05-08 18:32:35 +02:00
### bitbackup prune
2023-11-05 11:35:03 +01:00
```
2024-05-08 18:32:35 +02:00
bitbackup prune origin --since 2021-10-04
bitbackup prune abc --since "2 months ago" | 10 … does not delete anything, only marks objects to be deleted
2023-11-05 11:35:03 +01:00
```
### verify
```
2024-05-08 18:32:35 +02:00
bitbackup verify abc
2023-11-05 11:35:03 +01:00
```
### repack
## Todo
2023-09-28 19:22:47 +02:00
Table FILE add new columns linux_rights, owner, group