Back to Serve

{octicon}`desktop-download` Install

docs/get-started/install.md

3.34.02.8 KB
Original Source

(install)=

{octicon}desktop-download Install

Jina-serve comes with multiple installation options, enabling different feature sets. Standard install enables all major features of Jina-serve and is the recommended installation for most users.

{tab}
```shell
pip install -U jina
```
{tab}
```shell
conda install jina -c conda-forge
```
{tab}
```shell
docker run jinaai/jina:latest
```

More install options

Version identifiers are explained here.

Minimum

Minimum install enables basic features of Jina-serve, but without support for HTTP, WebSocket, Docker and Hub.

Minimum install is often used when building and deploying an Executor.

{tab}

```shell
JINA_PIP_INSTALL_CORE=1 pip install jina
```


{tab}

```shell
conda install jina-core -c conda-forge
```

{tab}

```shell
docker run jinaai/jina:latest
```

Minimum but more performant

Same as minimum install, but also install uvloop and lz4.

{tab}

```shell
JINA_PIP_INSTALL_PERF=1 pip install jina
```


{tab}

```shell
conda install jina-perf -c conda-forge
```

{tab}

```shell
docker run jinaai/jina:latest-perf
```

Full development dependencies

This installs additional dependencies, useful for developing Jina-serve itself. This includes Pytest, CI components etc.

{tab}

```shell
pip install "jina[devel]"
```


{tab}

```shell
docker run jinaai/jina:latest-devel
```

Prerelease

Prerelease is the version always synced with the master branch of Jina-serve's GitHub repository.

{tab}

```shell
pip install --pre jina
```


{tab}

```shell
docker run jinaai/jina:master
```

Autocomplete commands on Bash, Zsh and Fish

After installing Jina via pip, you should be able to use your shell's autocomplete feature while using Jina's CLI. For example, typing jina then hitting your Tab key will provide the following suggestions:

bash

jina 

--help          --version       --version-full  check           client          flow            gateway         hello             pod             ping            deployment            hub

The autocomplete is context-aware. It also works when you type a second-level argument:

bash

jina hub 

--help  new     pull    push

Currently, the feature is enabled automatically on Bash, Zsh and Fish. It requires you to have a standard shell path as follows:

ShellConfiguration file path
Bash~/.bashrc
Zsh~/.zshrc
Fish~/.config/fish/config.fish