Lungo

A user-friendly home lab setup designed for small-to-mid-scale on-premises hosting.

Features

• Complete configurability - manage everything declaratively through YAML files
• Seamless interoperability - access all applications via a single sign-on portal
• Batteries included - extend functionality with both built-in and custom plugins
• Containerized solution - designed to operate in a rootless Docker environment
• Security by default - use HTTPS and secure server settings across the system

Installation

The recommended way to install Lungo is via pipx:

pipx install lungo-cli

Note that Lungo is built upon Docker Compose. Before proceeding, please ensure that Docker is installed on your machine.

Alternatively, you can use Podman Compose with Podman. You can also use Docker Compose with Podman.

For instructions on setting up these tools, please refer to their respective documentation.

Quickstart

Copy the example configuration files to the platform-specific configuration directory. For example, on Linux, you can use the following command:

mkdir -p ~/.config/lungo
cp examples/* ~/.config/lungo

Edit the configuration files according to your preferences. Then, launch the Lungo service by running the following command:

lungo up

Documentation

For more information, please refer to the documentation.

License

This project is licensed under the MIT License. See LICENSE for details.