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

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

You can also use registry.firefish.dev/firefish/firefish-cli container image.

Please replace fishctl ___ commands with

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

# or

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

to run it inside a container.

If you are using a container network (which is typically the case if you using docker-compose.yml to run Firefish), you also have to specify the network name like this:

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

# or

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

You can search for your network name by docker network ls or podman network ls.

Usage

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

Migrate 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 migrate <revision>

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