Skip to content
@hlhv

Holanet Hive Server

The modular webserver that powers holanet.
README.md

hlhv

HLHV Banner

HLHV is a modular, hot-pluggable HTTPS server. It is designed to simplify the process of creating sites that have differently behaving sections.

How Does It Work?

HLHV redirects incoming HTTPS requests to sub-servers called cells which mount themselves on different parts of a URL. Cells connect to a central server (called the queen cell) over TLS sockets, which allows the entire system to be distributed across multiple machines or containers. Since cells connect to the queen and not the other way around, the queen is the only server that needs to have open ports.

Cells can mount on different URL paths, subdomains, etc. Upon receiving an HTTPS request, the queen will direct it to the cell with the most specific matching mount. For example, if there is a cell mounted on @/photos, and another on @/photos/dinosaurs, and a request comes in for @/photos/dinosaurs/debian.webp, it will be directed to the cell mounted on @/photos/dinosaurs. The cell would receive the entire request path, and send the correct file to the queen, where it would be sent back to the end user.

Getting Started

For more information about how the HLHV protocol works, visit the protocol repository. To get started with HLHV, you can build and install the queen cell and create your own cells using the cell module.

Please note: HLHV is not production ready. There may be bugs, and I wouldn't use it for anything more than a personal site at the moment.

Pinned Loading

  1. hlhv-queen hlhv-queen Public

    Queen cell

    Go

  2. cell cell Public

    Revised HLHV cell module

    Go

  3. hivectl hivectl Public

    HLHV cell controller

    Go

  4. wrench wrench Public

    Swiss army knife for configuring HLHV

    Go

Repositories

Showing 9 of 9 repositories
  • fsock Public

    Simple socket framing module for HLHV (go version)

    hlhv/fsock’s past year of commit activity
    Go 0 GPL-3.0 0 0 0 Updated Sep 26, 2022
  • hivectl Public

    HLHV cell controller

    hlhv/hivectl’s past year of commit activity
    Go 0 AGPL-3.0 0 0 0 Updated Sep 26, 2022
  • hlhv-queen Public

    Queen cell

    hlhv/hlhv-queen’s past year of commit activity
    Go 0 AGPL-3.0 0 0 0 Updated Aug 31, 2022
  • cell Public

    Revised HLHV cell module

    hlhv/cell’s past year of commit activity
    Go 0 GPL-3.0 0 1 0 Updated Aug 31, 2022
  • scribe Public

    Logs with symbols on them

    hlhv/scribe’s past year of commit activity
    Go 0 GPL-3.0 0 0 0 Updated Aug 31, 2022
  • wrench Public

    Swiss army knife for configuring HLHV

    hlhv/wrench’s past year of commit activity
    Go 0 GPL-3.0 0 0 0 Updated Aug 26, 2022
  • protocol Public

    The HLHV protocol

    hlhv/protocol’s past year of commit activity
    Go 0 GPL-3.0 0 0 0 Updated Aug 22, 2022
  • cellkit Public archive

    Old HlHV cell module

    hlhv/cellkit’s past year of commit activity
    Go 0 GPL-3.0 0 0 0 Updated Jul 7, 2022
  • .github Public
    hlhv/.github’s past year of commit activity
    0 0 0 0 Updated Jul 4, 2022

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…