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 ___

Where network_name is the network name on which the database is running. If you want to use this for the host network (i.e., use the container as if it were a locally installed command), you should replace network_name with host.

If you are using a container network (which is typically the case if you are using docker-compose.yml to run Firefish), you need to 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

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