Troubleshooting
IJulia/Jupyter installation
This is the part of the installation that is most likely to fail since IJulia depends on Jupyter and therefore Python.
Generally, the IJulia installation strategy is to check if there is a system-wide python available. If that's the case, it tries to install jupyter there. If not, it installs a boxed mini python (through Conda.jl). You can trigger the IJulia installation by
using Pkg
Pkg.add("IJulia")
as I show in this youtube video.
IJulia can't find my global python
In this case, fire up Julia and enter
ENV["PYTHON"] = "path/to/python"
where path/to/python
is the path to you python installation. Note that the path should include the executable as well! Hence, on windows, it is path/to/python.exe
and not just path/to/
.
Afterwards, rebuild IJulia (or ] add IJulia
if you haven't tried to install it)
using Pkg
Pkg.build("IJulia")
IJulia fails to install a mini python
In this case I recommend to install a global python separately and then use the steps explained above (IJulia can't find my global python).
On linux, you should use your package manager to install python and jupyter.
On windows, you can install Anaconda.
For more information check out the Jupyter documentation.
Manual installation of a workshop
If, for some reason, the WorkshopWizard doesn't work for you, you can use these manual instructions to install a workshop manually. We will demonstrate the necessary stepts for the JuliaNRW21
workshop.
Downloading the workshop
If you have git
installed, just git clone https://github.com/crstnbr/JuliaNRW21
. If you don't have git
installed, or can't access it from the commmand line, start a fresh Julia instance and run
using LibGit2
LibGit2.clone("https://github.com/crstnbr/JuliaNRW21", "some/where/on/my/computer/JuliaNRW21")
where you replace some/where/on/my/computer/
with a download path to your liking.
Installing and precompiling the dependencies
Open up a Julia REPL and navigate to the JuliaNRW21
directory
cd("some/where/on/my/computer/JuliaNRW21")
We now install all Julia package dependencies (instantiate the workshop's Julia environment) and precompile them by running the following snippet
using Pkg
pkg"activate ."
pkg"instantiate"
pkg"precompile" # this may take a while
pkg"activate"
Making IJulia globally available
You probably want to add IJulia to the global Julia environment, typically called v1.x
. To do this, start a fresh Julia REPL (or ] activate
) and execute
] add IJulia
If you have installed and precompiled the workshop dependencies before this should take almost no time, since IJulia is already installed. It just needs to be added to the environment.
Things are set up correctly if you can start the notebook server in a fresh Julia REPL with
using IJulia
notebook()