How to set up JaguarDB with Docker

JaguarDB is a massively scalable vector database designed for large-scale AI applications. It features a ZeroMove architecture, allowing enterprises to scale out dynamically without downtime or performance bottlenecks. This makes it ideal for AI-driven workloads, such as Agentic systems, recommendation systems, search, and generative AI.

Docker deployment is one of the three main ways to deploy JaguarDB across different environments, whether you’re using Cloud, MacOS, Windows, or Linux. Docker containers provide a fast, isolated, and scalable way to set up JaguarDB without complex installation steps.

To install JaguarDB, you can use docker to quickly setup JaguarDB. Note that jaguardb has the JaguarDB vector server and a Http server.

docker pull jaguardb/jaguardb

Once the server components are installed on your local machine, you can start the required servers:

docker run -d -p 8888:8888 -p 8080:8080 -p 4433:4433--name jaguardb jaguardb/jaguardb

Installed alongside the JaguarDB Docker packages is a client program that interacts with the JaguarDB server. Users can send commands to the vector database server using the client program and receive responses from the server. To launch the JaguarDB client terminal to interact with JaguarDB server, a user can execute the following command:

docker exec -it jaguardb /home/jaguar/jaguar/bin/jag -apikey demouser

Please note that package jaguardb contains the HTTP gateway which acts a proxy for the backend JaguarDB server. Package jaguardb_with_http opens up ports 8080 and 8888. Port 8080 is for HTTP traffic, 4433 for HTTPS, and 8888 for data exchange between the HTTP gateway and the backend JaguarDB vector database server. Note that the benefit of a HTTP server is that it provides a REST API to clients that run on any platforms such as MacOS, Windows, and Linux, with any programming language such as Python, JavaScript, C++, Java, etc.

The client program communicates with the HTTP gateway using the HTTP protocol, which then translates and forwards requests to the backend JaguarDB server. The server processes the requests and sends responses back to the HTTP gateway, which in turn delivers them to the client. This gateway enhances flexibility in programming and implementing AI applications.

Client  <==============>  HTTP Gateway  <===============> JaguarDB
                      (port 8080 or 4433)               (port 8888)

The API key “demouser” is the default authorization key for accessing the database server. It is automatically generated during package deployment. Administrators and users can create additional API keys to manage access to the JaguarDB system.

For more details, visit the official JaguarDB website at http://www.jaguardb.com to learn more.