issy
Navigation — Configuration

Configuration

issy is designed to work with zero configuration. For cases where you need to customize behavior, environment variables are available.

Environment variables

VariableDescriptionDefault
ISSY_DIRPath to the issy directory./.issy
ISSUES_PORTPort for the web UI server1554
ISSUES_HOSTHost the web UI server listens on127.0.0.1

ISSY_DIR

Override the default .issy directory location:

ISSY_DIR=/path/to/custom/.issy issy list

This is useful when your issues directory is in a non-standard location.

ISSUES_PORT

Change the port for the web UI server:

ISSUES_PORT=3000 issy

The web UI will then be available at http://localhost:3000.

ISSUES_HOST

The web UI listens on 127.0.0.1 by default, so only your own machine can reach it. To open it from somewhere else, such as from outside a container, set the host it listens on:

ISSUES_HOST=0.0.0.0 issy

Anyone who can reach that address can then read your issues, so only do this on a network you trust.

Directory resolution

By default, issy looks for .issy/ in the current directory and walks upward through parent directories until it finds one. This means you can run commands from any subdirectory in your project.

See Monorepo Support for details on how this works in monorepo setups.

Version pinning

When collaborating, pin your issy version in package.json:

npm install issy --save-dev

Global issy automatically defers to the local version if one exists, ensuring everyone on the team uses the same version.