Stormkit local setup: activate mise in your shell and install vips plus pkg-config

TL;DR

Issue stormkit-io/stormkit-io#5 (closed, 8 comments): A contributor setting up Stormkit locally hit two problems: after mise install reported success, go was still not found because the mise shims were not activated in the shell, and the hosting service crashed on startup with pkg-config: executable file not found because the bimg image-processing library needs libvips system libraries.

When to use

You are seeing this: The reporter also found the README outdated and a hosts-file tweak needed for the /instance and /providers APIs. Use this skill when you run into "Stormkit local setup: activate mise in your shell and install vips plus pkg-config".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

The problem

Issue stormkit-io/stormkit-io#5 (closed, 8 comments): A contributor setting up Stormkit locally hit two problems: after mise install reported success, go was still not found because the mise shims were not activated in the shell, and the hosting service crashed on startup with pkg-config: executable file not found because the bimg image-processing library needs libvips system libraries. The fixes: add eval "$(mise activate zsh)" to the shell config, and brew install vips pkg-config on macOS. The reporter also found the README outdated and a hosts-file tweak needed for the /instance and /providers APIs. The maintainer thanked them and agreed to update the docs.

The fix

Setting up Stormkit locally and something is off? Two common gotchas from a contributor's report. First, if mise install says everything is installed but go is still not found, the mise shims are not active in your shell: add eval "$(mise activate zsh)" to your shell config, reload it, and verify with which go. Second, if the hosting service crashes immediately with pkg-config: executable file not found, that comes from the bimg image-processing library, which needs libvips system libraries: on macOS run brew install vips pkg-config, verify with pkg-config --modversion vips, then restart with ./scripts/start.sh. Also check the current README before following older guides, and if the /instance and /providers APIs return 500s, your hosts file may need the documented local entries.

Notes

Thread: https://github.com/stormkit-io/stormkit-io/issues/5. Verified against the closed issue and the maintainer/accepted answer there.

In https://github.com/stormkit-io/stormkit-io/issues/5, the reporter asked: Issue stormkit-io/stormkit-io#5 (closed, 8 comments): A contributor setting up Stormkit locally hit two problems: after mise install reported success, go was still not found because the mise shims were not activated in the shell, and the hosting service crashed on startup with pkg-config: executable file not found because the bimg image-processing library needs libvips system libraries. The fixes: add eval "$(mise activate zsh)" to the shell config, and brew install vips pkg-config on macOS. The reporter also found the README outdated and a hosts-file tweak needed for the /instance and /providers APIs. The maintainer thanked them and agreed to update the docs. The verified answer: Setting up Stormkit locally and something is off? Two common gotchas from a contributor's report. First, if mise install says everything is installed but go is still not found, the mise shims are not active in your shell: add eval "$(mise activate zsh)" to your shell config, reload it, and verify with which go. Second, if the hosting service crashes immediately with pkg-config: executable file not found, that comes from the bimg image-processing library, which needs libvips system libraries: on macOS run brew install vips pkg-config, verify with pkg-config --modversion vips, then restart with ./scripts/start.sh. Source thread: https://github.com/stormkit-io/stormkit-io/issues/5