gerri
/
server
3
3
Fork 0
Code Issues 10 Pull Requests Releases Activity
Gerri is your lovely, little home and lab server. https://gerri.io
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
30 Commits
1 Branch
0 Tags
86 KiB
HTML 83.4%
Shell 16.6%
 
 
main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'main'
${ noResults }
Go to file
dschier d0216a1553 Feature: chrony config 
It is now possible to define a pool or servers for chrony.

fixes: #21

Also a minor code style issue in usbguard was fixed.
 		2 years ago
.gitea Feature: snmp, tuned, finetuning 2 years ago
assets Rework: structuring and features 2 years ago
collections Rework: structuring and features 2 years ago
docs Feature: snmp, tuned, finetuning 2 years ago
inventories service refinements 2 years ago
roles Feature: chrony config 2 years ago
scripts Rework: structuring and features 2 years ago
tests Rework: structuring and features 2 years ago
.ansible-lint Rework: structuring and features 2 years ago
.editorconfig Feature: snmp, tuned, finetuning 2 years ago
.gitattributes Rework: structuring and features 2 years ago
.gitignore service refinements 2 years ago
.gitmessage Rework: structuring and features 2 years ago
.yamllint Feature: snmp, tuned, finetuning 2 years ago
CHANGELOG.md Rework: structuring and features 2 years ago
KUDOS.txt Rework: structuring and features 2 years ago
README.md Feature: snmp, tuned, finetuning 2 years ago
Vagrantfile Feature: snmp, tuned, finetuning 2 years ago
ansible.cfg Rework: structuring and features 2 years ago
install.yml Feature: passwordless sudo 2 years ago
service.yml service refinements 2 years ago
update.yml Rework: structuring and features 2 years 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