🐻‍❄️📦 charted-server by Noelware, LLC.

Open, powerful, and reliable Helm chart registry made in Rust.

charted-server is a free and open platform that helps host, test, and build Helm charts all over the world to any side project to enterprise work. Noelware built this platform to build the cloud that we put our sweat and tears into.

Installation

Locally via Git

Required Tools / Prerequisites:

• Rust
• Git
• 20GB of storage
• 2GB of system RAM

To clone the repository, you can use the git pull command:

# HTTPS
$ git pull https://github.com/charted-dev/charted

# SSH
$ git pull [email protected]:charted-dev/charted

Once you cloned the repository, you can cd into it and run the charted CLI:

$ cargo cli

This will run the actual CLI, to run the server, you will need to use this instead:

$ cargo server

Docker

Important

You can checkout the charted-dev/self-hosted repository for a production ready charted-server instance with Docker Compose.

Kubernetes/Helm

Refer to the charted-dev/helm-charts repository for more information on how to deploy a charted-server instance on Kubernetes.

Nix/NixOS

Nix

You can use the charted and charted-helm-plugin Nix derivations from nixpkgs-noelware:

{
    inputs = {
        nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
        noelware = {
            url = "github:Noelware/nixpkgs-noelware";
            inputs.nixpkgs.follows = "nixpkgs";
        };
    };

    outputs = { nixpkgs, noelware, ... }: let
        system = "x86_64-linux";
        pkgs = import nixpkgs {
            inherit system;

            overlays = [(import noelware)];
        };
    in
    {
        devShells.${system}.default = pkgs.mkShell {
            buildInputs = with pkgs; [
                charted

                (wrapHelm kubernetes-helm {
                    plugins = [charted-helm-plugin];
                })
            ];
        };
    };
}

NixOS

The nixpkgs-noelware repository contains a NixOS module to run a charted-server instance:

{
    services.charted = {
        enable = true;
        statePath = "/var/lib/noelware/charted/data";

        settings = {
            single_user = true;
            sessions.backend.static = {
                noel = "<argon2 hashed password>";
            };
        };
    };
}

Contributing

Thanks for considering contributing to charted-server! Before you boop your heart out on your keyboard ✧ ─=≡Σ((( つ•̀ω•́)つ, we recommend you to do the following:

• Read the Code of Conduct
• Read the Contributing Guide

If you read both if you're a new time contributor, now you can do the following:

• Fork me! ＊*♡( ⁎ᵕᴗᵕ⁎ ）
• Clone your fork on your machine: git clone https://github.com/your-username/charted
• Create a new branch: git checkout -b some-branch-name
• BOOP THAT KEYBOARD!!!! ♡┉ˏ͛ (❛ 〰 ❛)ˊˎ┉♡
• Commit your changes onto your branch: git commit -am "add features （｡>‿‿<｡ ）"
• Push it to the fork you created: git push -u origin some-branch-name
• Submit a Pull Request and then cry! ｡･ﾟﾟ･(థ Д థ。)･ﾟﾟ･｡

License

charted-server by Noelware, LLC. is released under the Apache 2.0 License with love and care by the team. Please read the LICENSE file in the canonical repository for more information on what you can do with the source code for charted-server.