Link

FAQ / Troubleshooting

Return Home>

Page Contents

What is jlenv?

jlenv is a tool for simple Julia version management.

How is this better than …?

See Why jlenv?

How do I install jlenv?

  1. Use the jlenv-installer

    curl -fsSL https://github.com/jlenv/jlenv-installer/raw/master/bin/jlenv-installer | bash
    # OR
    wget -q https://github.com/jlenv/jlenv-installer/raw/master/bin/jlenv-installer -O- | bash
    
  2. Follow to the Documented instructions.

What is allowed in a .julia-version file?

The string read from a .julia-version file must match the name of an existing directory in ~/.jlenv/versions/. The installed Julia versions are listed by the command jlenv versions.

If you’re using julia-build, typically this will be one of its Julia version names.

Other version managers might allow fuzzy version matching on the string read from .julia-version file, e.g. they might allow “1.0.3” (without patch suffix) to match the latest Julia 1.0.3 release.

jlenv will not support this: such behavior is unpredictable, hence unsafe.

How to verify that I have set up jlenv correctly?

  1. Check that jlenv is in your PATH:

     which jlenv
    
  2. Check that jlenv’s shims directory is in PATH:

     echo $PATH | grep --color=auto "$(jlenv root)/shims"
    

    If not, see the jlenv init step installation instructions.

jlenv is installed but not working for me.

Please search existing issues and open a new one if you had problems using jlenv.

The jlenv-doctor script analyzes your system setup for common problems. You can use Gist to paste the results online and share it in your bug report:

Which shell startup file do I put jlenv config in?

Typically it’s one of the following:

  • bash: ~/.bash_profile (or ~/.bashrc on Ubuntu Desktop)
  • zsh: ~/.zshrc
  • fish: ~/.config/fish/config.fish
  • other: ~/.profile

See Unix shell initialization for more info about how config files get loaded.