Cermofi Scripts

Operational Bash scripts installable through Basher.

Scripts live in bin/. Basher exposes files from bin/ as commands in PATH, so each script should be executable and usable on its own.

Install Basher

Official installer:

curl -s https://raw.githubusercontent.com/basherpm/basher/master/install.sh | bash

Initialize Basher in the current shell:

export PATH="$HOME/.basher/bin:$PATH"
eval "$(basher init - zsh)"

For Bash:

export PATH="$HOME/.basher/bin:$PATH"
eval "$(basher init - bash)"

On macOS, install required tools if needed:

brew install bash coreutils

Verify:

basher help
basher commands

Install This Package

For the private Gitea SSH remote, configure SSH:

Host git.cermofi.cz
    HostName git.cermofi.cz
    Port 222
    User git
    IdentityFile ~/.ssh/id_rsa
    IdentitiesOnly yes

Install through Basher:

basher install --ssh git.cermofi.cz/cermofi/scripts

One-off install without changing SSH config:

GIT_SSH_COMMAND='ssh -i ~/.ssh/id_rsa -o IdentitiesOnly=yes -p 222' basher install --ssh git.cermofi.cz/cermofi/scripts

Local development:

basher link --no-deps /path/to/scripts cermofi/scripts

Scripts

Full script index: docs/scripts/README.md

Script	Purpose
create-vps-project.sh	Create a VPS project user, home directory, nginx reverse proxy, and certificate.
remove-vps-project.sh	Remove a VPS project user, home directory, nginx reverse proxy, and certificate.
network-limits.sh	Interactive Linux traffic limit manager for IP and MAC based tc limits.
prerequisites-logman.sh	LogMan.io pre-install checks.
pre-upgrade-check.sh	Linux distribution upgrade readiness checks.
post-upgrade-check.sh	Linux distribution post-upgrade verification checks.

Add a Script

1. Put the executable script into bin/.
2. Add --help if the script accepts arguments.
3. Keep it standalone so it works through a Basher symlink.
4. Add a short doc page under docs/scripts/.
5. Add it to docs/scripts/README.md.
6. Check syntax before committing:

bash -n bin/script-name.sh

If available:

shellcheck bin/script-name.sh

Rules

• Scripts must be executable.
• Shell scripts use LF line endings; .gitattributes enforces this.
• Check scripts should print clear OK, WARN, and FAIL results.