Firefish CLI tool

Install and Update

Install pre-built executable using cargo-binstall

# If you don't have cargo-binstall, install it first
# curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash

# Install pre-built executable
cargo binstall --locked --git https://firefish.dev/firefish/firefish-cli.git

You can update the package using the same command.

cargo binstall --locked --git https://firefish.dev/firefish/firefish-cli.git

Download pre-built executable file

You can also download the pre-built executable file from the release page, but you need to manage/update the file on your own.

Install from source

# Build from source
cargo install --locked --git https://firefish.dev/firefish/firefish-cli.git

You can update the package using the same command.

cargo install --locked --git https://firefish.dev/firefish/firefish-cli.git

Use pre-built OCI image

Using the registry.firefish.dev/firefish/firefish-cli container image, fishctl ___ commands can be executed as

docker run -it --rm --volume "$(pwd)":/firefish --network network_name \
  registry.firefish.dev/firefish/firefish-cli \
  fishctl ___

# or

podman run -it --rm --volume "$(pwd)":/firefish --network network_name \
  registry.firefish.dev/firefish/firefish-cli \
  fishctl ___

If you are using a container network (which is typically the case if you using docker-compose.yml to run Firefish), you can search for your network name by docker network ls or podman network ls:

$ podman network ls  # the network name is `firefish_calcnet` in this case
NETWORK ID    NAME                      DRIVER
0060ac847249  firefish_calcnet          bridge
2f259bab93aa  podman                    bridge

If you want to use this in the host network, you should use host as the network name.

Usage

Please make sure to cd to the Firefish local repository before running these commands.

Update the config files

The admin note may tell you that you need to update the config files. In such a case, please execute the following command.

fishctl config update

Validate the config files

To validate the config files, run the following command. Note that this only performs a formal validation and does not check that the settings are appropriate. For example, this command does not check if the database password is correct.

fishctl config validate

2.7 KiB Raw Blame History