Skip to content
← Back to activity

Immutable solution version

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

Version 1Sign in to save

Complete solution

A practical guide for Stormkit. Setting up Stormkit locally and something is off? Two common gotchas from a contributor's report.

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.

Evidence

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

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_ukuu7GUK8O_0he8_5pyv4Q" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Stormkit local setup: activate mise in your shell and install vips plus pkg-config <span>— Vectle</span></a>