Add basic README
This commit is contained in:
parent
9072564230
commit
abbce47c0e
1 changed files with 49 additions and 1 deletions
50
README.md
50
README.md
|
@ -1,3 +1,51 @@
|
||||||
# tootpaste
|
# tootpaste
|
||||||
|
|
||||||
Toot(h)paste is a simple bash script to clean your Mastodon instance.
|
Toot(h)paste is a simple bash script to clean your Mastodon instance.
|
||||||
|
|
||||||
|
# How to install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ wget https://git.benpro.fr/benoit/tootpaste/raw/branch/main/tootpaste.sh \
|
||||||
|
-O /tmp/tootpaste.sh
|
||||||
|
$ sudo install -m 755 -o root -g root /tmp/tootpaste.sh /usr/local/bin/tootpaste
|
||||||
|
```
|
||||||
|
|
||||||
|
# How to use
|
||||||
|
|
||||||
|
By default it runs in dry-run mode.
|
||||||
|
To run without dry-run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ DRY_RUN=false tootpaste
|
||||||
|
```
|
||||||
|
|
||||||
|
## Parameters
|
||||||
|
|
||||||
|
There are no arguments, everything is managed by environment variables, here is
|
||||||
|
the list of what you can use:
|
||||||
|
|
||||||
|
- `DO_ACCOUNTS_CULL`, boolean, run or not accounts cull step, default: `true`
|
||||||
|
- `DO_MEDIA_REMOVE`, boolean, run or not media remove step, default: `true`
|
||||||
|
- `DO_STATUSES_REMOVE`, boolean, run or not statuses remove step, default:
|
||||||
|
`true`
|
||||||
|
- `DO_CACHE_RECOUNT`, boolean, run or not cache recount step, default: `true`
|
||||||
|
- `TOOTCTL`, string, path to tootctl binary, default:
|
||||||
|
`/home/mastodon/live/bin/tootctl`
|
||||||
|
- `DB_POOL`, integer, concurrency to use (connections to PostgreSQL), default:
|
||||||
|
- `DRY_RUN`, boolean, run or not in dry-run mode, default: `true`
|
||||||
|
- `TLS_EXPIRED_MAX_SEC`, integer, number of seconds, age difference between now
|
||||||
|
and date of expired certificate, default: `1210000`, 2w
|
||||||
|
- `INSTANCE_LAST_CHANCE_TIMEOUT`, integer, timeout in seconds to connect to an
|
||||||
|
instance that was previously not accessible, default: `30`
|
||||||
|
- `MEDIA_REMOVE_DAYS`, integer, how old in days media attachments have to be
|
||||||
|
before getting removed
|
||||||
|
- `CARDS_REMOVE_DAYS`, integer, how old in days cards previews have to be
|
||||||
|
before getting removed
|
||||||
|
- `STATUSES_REMOVE_DAYS`, integer, how old in days unreferenced statuses have
|
||||||
|
to be before getting removed
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ DRY_RUN=false DO_CACHE_RECOUNT=false DB_POOL=50 tootpaste
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in a new issue