Install

Install distributed version by conda

We are based on miniforge, which provides the minimal installers for Conda and Mamba specific to conda-forge. The packages of the base are from the conda-forge channel. conda-forge is the default and only channel configured. MSS is available as a conda package on the channel.

conda-forge/mss

The conda-forge channel has builds for osx-64, linux-64 and win-64.

The conda-forge github organization uses various automated continuous integration build processes.

You must install mss into a new environment to ensure the most recent versions for dependencies:

$ mamba create -n mssenv mss
$ mamba activate mssenv
(mssenv) $ mss -h

Afterwards reactivate the environment, this sets all env variables needed.

(mssenv) $ mamba deactivate
$ mamba activate mssenv

For updating an existing MSS installation to the current version, it is best to install it into a new environment. If an existing environment shall be updated, it is important to update all packages in this environment.

$ mamba activate mssenv
(mssenv) $ mamba update mss
(mssenv) $ mamba update --all

Usage

GUI

To start the MSS UI you can lookup for “mss” on your desktop program manager or use a terminal

(mssenv) $ mss

The configuration is described in the section mss-configuration

mswms server

To try out the setup you can use demo data. Read about a server based installation.

(mssenv) $ mswms_demodata --seed
(mssenv) $ mswms

This data is then available on localhost:8081. The capabilities can be read on a web browser too.

mscolab server

To tryout the setup you can use demo data. Read about a server based installation.

(mssenv) $ mscolab db --init
(mssenv) $ mscolab db --seed
(mssenv) $ mscolab start

The service is than availale on localhost:8083 and can be verified by the server status

Further information about installation options

Please read details on http://mss.rtfd.io