Binsight follows 12-factor application design principles. Every configuration option can be passed via command line flags or defined as environment variables prefixed with BINSIGHT_.
Command Line Flags
| Flag | Default | Description |
|---|---|---|
| --bind | 127.0.0.1 | Network interface to listen on. Use 0.0.0.0 inside containers. |
| --port | 8080 | HTTP server port for the visual console. |
| --data-dir | ~/.binsight | Directory where the local SQLite index cache is stored. |
| --clean-index | false | Wipes the SQLite index on startup and forces a re-index. |
| --stream.enabled | false | Enables live MySQL replication streaming over port 3306. |
| --stream.host | 127.0.0.1 | Remote MySQL primary / replica hostname or IP. |
| --stream.port | 3306 | Remote MySQL server port. |
| --stream.user | root | Replication user account name. |
| --stream.flavor | mysql | Protocol dialect: mysql or mariadb. |
Environment Variables (BINSIGHT_*)
For Docker and systemd deployments, configure options via environment variables:
| Environment Variable | Equivalent Flag |
|---|---|
| BINSIGHT_BIND | --bind |
| BINSIGHT_PORT | --port |
| BINSIGHT_DATA_DIR | --data-dir |
| BINSIGHT_STREAM_ENABLED | --stream.enabled |
| BINSIGHT_STREAM_HOST | --stream.host |
| BINSIGHT_STREAM_PASSWORD | --stream.password |
Configuration Precedence
When options are defined in multiple locations, Binsight evaluates them in the following order:
- Command line flags (highest precedence)
- Environment variables (
BINSIGHT_*) - Built-in application defaults (lowest precedence)