Welcome to the Helm chart for Fab City OS Core! This chart is designed to be a lightweight way to configure the Fab City OS Core official Docker images.
Fab City OS Core is a central component of the digital infrastructure of a Fab City. It can be easily installed and used by users as part of the Fab City Software Kit. This component enables the efficient production and marketing of Open Source Hardware at all levels of the value chain of distributed production.
Our vision is to promote a green, resilient, and digitally-based mode of production and consumption that enables the greatest possible sovereignty, empowerment and participation of citizens all over the world.
We want to help Fab Cities to produce everything they consume by 2054 on the basis of collaboratively developed and globally shared data in the commons.
To know more [DOWNLOAD THE WHITEPAPER](https://www.interfacerproject.eu/assets/news/whitepaper/IF-WhitePaper_DigitalInfrastructureForFabCities.pdf).
## Table of Contents <!-- omit in toc -->
- [About the **INTERFACER** Project](#about-the-interfacer-project)
- [🚀 Getting Started](#-getting-started)
- [Prerequisites](#prerequisites)
- [Install a Kubernetes distribution](#install-a-kubernetes-distribution)
- [Install kubectl](#install-kubectl)
- [Install helm](#install-helm)
- [Add the helm repository](#add-the-helm-repository)
- [💾 Install Fab City OS Core](#-install-fab-city-os-core)
Kubernetes (K8s), is an open-source system for automating deployment, scaling, and management of containerized applications. You can run a Fab City OS Core instance inside your Kubernetes cluster, either if you want to expose it to the outside world or just let some other applications use it inside your cluster and take advantage of the instant and powerful search engine.
First of all, you will need a Kubernetes cluster up and running. If you are not familiar with how Kuberentes works or need some help with this step, please check the [Kubernetes documentation](https://kubernetes.io/docs/home/).
If you use the [nix package manager](https://nixos.org/), the following components will be automatically installed for you. Otherwise, please install these components manually before deploying the application.
#### Install a Kubernetes distribution
Before deploying this application, it is important to have a Kubernetes 1.19+ distribution installed.
We recommend using a lightweight Kubernetes distribution like [k3s](https://k3s.io/) for optimal performance and resource utilization.
`kubectl` is the most commonly used CLI to manage a Kubernetes cluster. The installation instructions are [available here](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
`helm` is a Command Line Interface which will automate chart management and installation on your Kubernetes cluster. To install Helm, follow the [Helm installation instructions](https://helm.sh/docs/intro/install/).
Check out the [values.yaml](./values.yaml) for recommended configurations to use in your environment. You can also find more details about [components](#components) configurations.
### Uninstalling
To uninstall/delete the Fab City OS Core deployment:
Any new contribution is more than welcome in this project! If you want to know more about the development workflow or want to contribute, please visit our [contributing guidelines](/CONTRIBUTING.md) for detailed instructions!
