Crate moella

source ·
Expand description

Mölla

This is the reference implementation of the Kvarn server library, offering a simple config to get you started using Kvarn.

See moella --help for config options

It’s for my personal use on my domains icelk.dev and kvarn.org.

See kvarn.org for an example config and the schema of the config. You can also take a look at the icelk.dev config for a production example.

Usage

See kvarn.org.

Installation

There are builds available for Linux in Github Actions, and for other platforms under Releases.

To run it, download the binary appropriate for your platform.

  • Platform specifics:
    • If you run Linux: run chmod +x <downloaded binary> to make it executable.
    • If you run macOS: run chmod +x <downloaded binary>, then open Finder and find the binary. Right click and click Open. Accept the warning.
    • On Windows, it should just run
  • Lastly, run the command ./<downloaded binary> --help in your shell to get usage information.

Build from source

Install Rust and then run the following:

This doesn’t currently work, as we haven’t published to crates.io yet. You’ll have to set up the development environment.

$ cargo install moella

Documentation

Development

During development, Mölla requires Kvarn to be cloned at ../kvarn, Kvarn Search at ../kvarn-search, and Kvarn Auth at ../kvarn-auth.

Re-exports

Modules

Functions

  • CLI argument parser.
  • Sets up logging, starts the server, and returns the handle. Also handles argument parsing.