fishctl/README.md

# Firefish CLI tool

## Install and Update

### Install pre-built executable using [cargo-binstall](https://github.com/cargo-bins/cargo-binstall)

```sh
# 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.

```sh
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](https://firefish.dev/firefish/firefish-cli/-/releases), but you need to manage/update the file on your own.

### Install from source

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

You can update the package using the same command.

```sh
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

```sh
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](https://firefish.dev/firefish/firefish/-/blob/main/docs/notice-for-admins.md) may tell you that you need to update the config files. In such a case, please execute the following command.

```sh
fishctl config update
```

You can also specify the revision to update to, but this feature is for development purposes only.

```sh
fishctl config update v1
```

### Validate the config files

Execute the following command to validate the config files.

```sh
fishctl config validate
```

Note that some items are only formally checked, so even if the output says it is valid, your settings may not be appropriate.

This command performs a connection check against the PostgreSQL server and the Redis/Valkey server. You can bypass this check using the `--offline` option:

```sh
fishctl config validate --offline
```

### Generate VAPID keys for push notifications

```sh
fishctl generate vapid
```