Can I Run Jina On ….?¶
Linux distributions (not to mention notebooks and other Python environments) are like a box of chocolates. They’re all different, and you never know what you’re going to get.
While installing Jina on Ubuntu is pretty straightforward, other distributions may have their quirks, either with Jina directly or with some of the tools around Jina (like Docker for example). This document aims to be a one-stop resource for any issues you may encounter on different distros, operating systems, or running in notebooks.
0.8.6 Jina runs smoothly on Jupyter Lab/Notebook. For better experience, use
AsyncFlow instead of
Jina requires Python 3.7/3.8/3.9. At the time of writing Google Colab runs Python 3.6.7 so Jina can’t be installed via
While Jina hasn’t shown any quirks on Fedora, getting Docker up and running to test Jina examples can be troublesome. Two main errors commonly pop up on a fresh install:
Error: OCI runtime create failed: this version of runc doesn’t work on cgroups v2¶
To fix this:
Switch to root user and enter
sudo su cd /boot
grubenv in your text editor
Find the line starting with
kernelopts, and add
systemd.unified_cgroup_hierarchy=0 to the end of the line, ensuring there is a space before it. After that, reboot.
If you’ve got Jina running on other systems, we’d love to hear from you, and especially the steps you had to go through to make it work properly!