Skip to content

⚡️ Prerequisites

Before installing HESTIA, ensure you have the following dependencies installed:

  • Python 3.10+
  • Poetry or pip
  • Git
  • Docker & Docker Compose
  • Elasticsearch (Optional, for centralized logging)
  • Kibana (Optional, for log visualization)
  • Grafana (Optional, for advanced monitoring)

🐍 Python 3.10+

Ensure you have Python 3.10+ installed. If not, download and install it from the official Python website. Check your version:

python --version
For installation guides and troubleshooting, refer to the RealPython documentation.

📦 Package managers

Why We Recommend Poetry Over pip

While pip is the standard Python package manager, we strongly recommend using Poetry for managing dependencies.

  • Simplified Dependency Management – Poetry resolves, installs, and locks dependencies automatically, preventing version conflicts.
  • Built-in Virtual Environments – Unlike pip, Poetry creates and manages isolated environments for your projects.
  • Reproducible Installs – Poetry uses pyproject.toml and poetry.lock to ensure consistency across different environments.
  • Better Publishing Workflow – If you plan to contribute or package Hestia extensions, Poetry makes publishing to PyPI seamless.

For long-term projects and production environments, Poetry provides a more robust and scalable solution than pip.

Install Poetry as package manager and dependencies management:

curl -sSL https://install.python-poetry.org | python3 -

Check if Poetry is installed correctly:

poetry --version

Knowledge

If you don't have prior experience with Python, we recommend reading Using Python's pip to Manage Your Projects' Dependencies, which is a really good introduction on the mechanics of Python package management and helps you troubleshoot if you run into errors.

Upgrade pip to the latest version: 

python -m pip install --upgrade pip

🌱 Git

Ensure you have Git installed. If not, download and install it from the official Git website. Check your version:

git --version

🐳 Docker & Docker Compose

To demonstrate HESTIA Asynchronous Logger using Docker, ensure you have Docker and Docker Compose installed. Download and install Docker from the official website:

Verify installation with: 

docker version

docker compose version

Why Docker?

  • Runs Hestia services in isolated containers
  • Makes it easier to deploy logging services like Elasticsearch, Kibana, and Grafana

Now that prerequisites are set, continue with configuration. 🎯