Install Moonshot Libraries on an Alpine Linux Client

On this page you will find instructions on how to install the Moonshot Libraries on an Alpine Linux device to enable its use as a Moonshot client.

Contents

Assumptions & Prerequisites

This guide assumes you have root access to the Linux device. This is required as new software needs to be installed system-wide.

1. Install the Moonshot Client libraries

Add the Required Repositories

Supported versions

At the moment, Alpine 3.11 and Alpine 3.13 (x86_64 and armhf) are supported.

  1. Add the Moonshot Alpine repository to your system. To do this, run the following command (as root, or using sudo):

    Alpine 3.13
    echo "https://repository.project-moonshot.org/alpine/v3.13" >> /etc/apk/repositories
    echo "@moonshot https://repository.project-moonshot.org/alpine/v3.13" >> /etc/apk/repositories
    Alpine 3.15
    echo "https://repository.project-moonshot.org/alpine/v3.15" >> /etc/apk/repositories
    echo "@moonshot https://repository.project-moonshot.org/alpine/v3.15" >> /etc/apk/repositories
  2. Install the Moonshot repository RSA key.

    curl "https://repository.project-moonshot.org/alpine/moonshot@jisc.ac.uk-5be46530.rsa.pub" > /etc/apk/keys/moonshot@jisc.ac.uk-5be46530.rsa.pub

We’re now ready to install the Moonshot software and its required dependencies. Install the software by running the following command:

apk add moonshot

2. Next steps

At this point, you now have all of the required Moonshot software on your device, including the Moonshot Identity Selector. Depending on what client application you are using and wish to enable Moonshot authentication for, you job may now be done, or you may need to go and install a Moonshot compatible version of the client software or configure your existing client. Check the section on client compatibility if you are unsure.