Extension uses system Ruby version - can't start Solargraph

[semaperepelitsa]

I am having trouble running Solargraph on my system. After opening the app, I am getting this error:

Language server solargraph:

from extension "Ruby" version 0.13.1: Failed to install gem 'solargraph': Gem command failed (status: 1)
Error: ERROR:  Error installing solargraph:
	There are no versions of prism (~> 1.4) compatible with your Ruby & RubyGems. Maybe try installing an older version of the gem you're looking for?
	prism requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.

The version mentioned here (2.6.10.210) is the one bundled with the latest MacOS. In my shell I have a script that automatically adds project-specific Ruby version to the PATH. I don't know how to make it work for Zed. In other editors (Sublime Text, VSCode) I could configure a custom path to Ruby binary, which has worked fine.

I am quite surprised that the documentation here does not mention this topic at all. Am I supposed to use the system Ruby version? Or is it supposed to support all popular Ruby version managers out-of-the-box? When I start a built-in Terminal panel, it does pick up the appropriate Ruby version correctly. I don't know how to debug it, is there any special verbose mode where I can see how exactly is it trying to run solargraph?

[vitallium]

Hi! This does look like an issue indeed. The Ruby extension works with popular Ruby version managers out of the box: rbenv, mise, asdf. Perhaps you are using something different? Could you please share more details?

In other editors (Sublime Text, VSCode) I could configure a custom path to Ruby binary, which has worked fine.

There is no such option in Ruby language settings in Zed but you can specify the binary path for each language server. It's not the best solution but it works. For example, for solargraph:

{
  "solargraph": {
    "binary": {
      "path": "<path_to_solargraph_binary>",
      "arguments": ["stdio"],
      "env": {
        "MY_ENV_VAR": "MY_ENV_VAR_VALUE"
      }
    }
  }
}

I don't know how to debug it, is there any special verbose mode where I can see how exactly is it trying to run solargraph?

You can check what the PATH variable is used in your project by looking for the line [project::environment] using project environment variables shell launched in in Zed logs.

Thanks!

[johnnagro]

I've been experiencing the problem as well. Up to date zed, Sequoia 15.6.1, homebrew installed mise, oh-my-zsh mise plugin. Opening a folder in zed (using zed cli directly, or via mise x -- zed .) which contains a .tool-versions results in the solargraph error above (uses system ruby, not mise-configured ruby)

HOWEVER configuring zed to use ruby-lsp installs/works properly, and if i have the claude code agent (installed via zed) run ruby -v i get the expected version (not the system version solargraph is finding). just the solargraph install seems to cause an error.

I am happy to provide other info/diagnostics.

[vitallium]

Hey, I've merged a possible fix to resolve the issue. Could you please check if it fixes your problem? To do that, you need to install the dev version of the extension:

1. Ensure you have installed Rust
2. Clone the repo
3. Open Zed and uninstall the current version of the extension
4. Click Install Dev Extension
5. Point to the cloned repo of the extension.
6. Wait a bit :)
7. Follow your reproduction steps.
8. Post the result

Thanks!

[johnnagro]

@vitallium i'm having trouble installing it as a dev extension and its not clear to me how to get debug/error logs from zed. i've followed https://github.com/zed-industries/zed/tree/main/crates/extension_api#compatible-zed-versions to get my env setup. i can cargo build in the checked out repo and it builds cleanly but installing it into zed fails with an error that it failed to compile the extension. any ideas?

[vitallium]

@vitallium i'm having trouble installing it as a dev extension and its not clear to me how to get debug/error logs from zed. i've followed https://github.com/zed-industries/zed/tree/main/crates/extension_api#compatible-zed-versions to get my env setup. i can cargo build in the checked out repo and it builds cleanly but installing it into zed fails with an error that it failed to compile the extension. any ideas?

Hi! I think you should see something in the Zed log file: open the command palette in Zed and search for zed: open log.

[johnnagro]

@vitallium thanks, here are the logs:

2025-09-10T19:34:40-04:00 ERROR [extensions_ui] Failed to install dev extension: failed to compile Rust extension

Caused by:
    failed to build extension    Compiling memchr v2.7.4
       Compiling yoke v0.7.5
       Compiling wasmparser v0.227.1
       Compiling cfg-if v1.0.0
       Compiling wasm-encoder v0.227.1
       Compiling prettyplease v0.2.32
       Compiling miniz_oxide v0.8.8
       Compiling form_urlencoded v1.2.1
    error[E0463]: can't find crate for `core`
      |
      = note: the `wasm32-wasip2` target may not be installed
      = help: consider downloading the target with `rustup target add wasm32-wasip2`
    
    For more information about this error, try `rustc --explain E0463`.
    error: could not compile `memchr` (lib) due to 1 previous error
    warning: build failed, waiting for other jobs to finish...

if i run rustup target add wasm32-wasip2 i see:

➜  ruby git:(main) rustup target add wasm32-wasip2
info: component 'rust-std' for target 'wasm32-wasip2' is up to date

[johnnagro]

@vitallium actually i was able to get my rust env setup correctly - i had to remove the homebrew rust and just use the rustup toolchain. i was able to get the dev extension installed based on an up2date checkout of this repo.

unfortunately, the error persists with solargraph:

Language server solargraph:

from extension "Ruby" version 0.13.1: Failed to install gem 'solargraph': Gem command failed (status: 1)
Error: ERROR:  Error installing solargraph:
	There are no versions of prism (~> 1.4) compatible with your Ruby & RubyGems. Maybe try installing an older version of the gem you're looking for?
	prism requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.

this is in a zed launched from the cli, where the env says:

> ruby -v
ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]

[vitallium]

@vitallium actually i was able to get my rust env setup correctly - i had to remove the homebrew rust and just use the rustup toolchain. i was able to get the dev extension installed based on an up2date checkout of this repo.

unfortunately, the error persists with solargraph:

Language server solargraph:

from extension "Ruby" version 0.13.1: Failed to install gem 'solargraph': Gem command failed (status: 1)
Error: ERROR:  Error installing solargraph:
	There are no versions of prism (~> 1.4) compatible with your Ruby & RubyGems. Maybe try installing an older version of the gem you're looking for?
	prism requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.

this is in a zed launched from the cli, where the env says:

> ruby -v
ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]

Great! I was able to reproduce the issue in a VM:

I will look into it. Thanks!

[vitallium]

@johnnagro Hi again! Can you please check if this PR resolves your issue? Thanks!

[johnnagro]

@vitallium that seems to work! i checked out that branch. rebuilt the dev extension. closed zed (probably didnt matter). then using zed cli i opened a rails app. solargraph installed without error and i started to see messages about caching gems, etc. language server suggestions seem to appear as i edit as expected.

[vitallium]

@johnnagro Awesome! Thanks for confirming. I will cut off the new release.

This issue is fixed in #176