Gerri is your lovely, little home and lab server. https://gerri.io
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
dschier d0216a1553 Feature: chrony config 5 months ago
.gitea Feature: snmp, tuned, finetuning 6 months ago
assets Rework: structuring and features 6 months ago
collections Rework: structuring and features 6 months ago
docs Feature: snmp, tuned, finetuning 6 months ago
inventories service refinements 5 months ago
roles Feature: chrony config 5 months ago
scripts Rework: structuring and features 6 months ago
tests Rework: structuring and features 6 months ago
.ansible-lint Rework: structuring and features 6 months ago
.editorconfig Feature: snmp, tuned, finetuning 6 months ago
.gitattributes Rework: structuring and features 6 months ago
.gitignore service refinements 5 months ago
.gitmessage Rework: structuring and features 6 months ago
.yamllint Feature: snmp, tuned, finetuning 6 months ago
CHANGELOG.md Rework: structuring and features 6 months ago
KUDOS.txt Rework: structuring and features 6 months ago
README.md Feature: snmp, tuned, finetuning 6 months ago
Vagrantfile Feature: snmp, tuned, finetuning 6 months ago
ansible.cfg Rework: structuring and features 6 months ago
install.yml Feature: passwordless sudo 5 months ago
service.yml service refinements 5 months ago
update.yml Rework: structuring and features 6 months ago

README.md

Gerri: Server

Gerri is your lovely, little home and lab server.

Motivation

A home server or lab environment should be easy to setup and operate. On the other hand, it should be powerful enough to run some VMs, Containers and prepared applications.

Description

With Gerri, we aim to provide a server solution, that is as easy to handle as a typical router or NAS solution. Gerri can be installed in a VM or bare metal and. It provides virtualization, container solutions and prepared applications, that will support your home office, home automation and development lab.

Architecture

The architecture for Gerri is very Linux and Container centric. If you want to get an understanding of the integrated Open Source software and core services, please have a look at the architecture documentation.

Features

Gerri provides some core features, that will allow to operate the server and deploy new applications and services on it. On top of a fully customizable GNU/Linux based OS, you will get a Web UI, Containers, Virtualization, Securtity improvements and much more. You can also add more prepared applications and services.

Please have a look at the detailed Feature List.

Install

The installation of Gerri does not install the base OS. It just adds packages, services, configuration, etc to make the machine "Gerri". ;)

Deployment

Gerri can be deployed in a VM, via Vagrant on fully fledged x86 bare metal servers, a small micro server or on a Raspberry Pi. Please check out the Installation instructions to get all the details.

Supported Devices

We are currently testing the following devices/instances for every tagged release.

Hardware:

  • RaspberryPi 4
  • RaspberryPi 3
  • x86_64 Intel based

Virtual:

  • Vagrant (libvirt backend)
  • QEMU/KVM

Usage

TBD

Administration

TBD

Services

Gerri is offering the server and additional services, that may be useful for development, lab and home usage.

Default Services

TBD

  • Admin (cockpit)
  • Proxy (traefik)
  • Monitor (statping)
  • Dashboard (homer)

Additional Service

TBD

  • Nextcloud
  • Gitlab
  • NFS Share
  • S3 Storage

Known Issues

None.

Changelog

The repository contains a curated, chronological changelog, maintained by the owner for each release/tag.

Contribution

Thank you so much for considering to contribute! We are happy, when someone is joining the hard work. Please feel free to contribute, after having a look at the Conventions.

See who has contributed already in the KUDOS.txt.

Development

TBD

License

Except where otherwise noted, all work is licensed under a BSD-3-Clause License.

Contact