Page tree
Skip to end of metadata
Go to start of metadata

On this page you will find instructions on how to install the Moonshot Libraries a Debian/Ubuntu/Raspbian 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. System Preparation

1.1. Add the Moonshot Repository

Supported versions

At the moment, we support Debian/Raspbian (8, 9, and 10) and Ubuntu (16.04 and 18.04).

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

    Debian 8
    wget https://repository.project-moonshot.org/debian-moonshot/moonshot-repository.debian8.deb
    dpkg -i moonshot-repository.debian8.deb
    Debian 9
    wget https://repository.project-moonshot.org/debian-moonshot/moonshot-repository.debian9.deb
    dpkg -i moonshot-repository.debian9.deb
    Debian 10
    wget https://repository.project-moonshot.org/debian-moonshot/moonshot-repository.debian10.deb
    dpkg -i moonshot-repository.debian10.deb
    Raspbian 8
    wget https://repository.project-moonshot.org/raspbian/moonshot-repository.raspbian8.deb
    dpkg -i moonshot-repository.raspbian8.deb
    Raspbian 9
    wget https://repository.project-moonshot.org/raspbian/moonshot-repository.raspbian9.deb
    dpkg -i moonshot-repository.raspbian9.deb
    Raspbian 10
    wget https://repository.project-moonshot.org/raspbian/moonshot-repository.raspbian10.deb
    dpkg -i moonshot-repository.raspbian10.deb
  2. Ubuntu 16.04
    wget https://repository.project-moonshot.org/debian-moonshot/moonshot-repository.ubuntu16.deb
    dpkg -i moonshot-repository.ubuntu16.deb
    Ubuntu 18.04
    wget https://repository.project-moonshot.org/debian-moonshot/moonshot-repository.ubuntu18.deb
    dpkg -i moonshot-repository.ubuntu18.deb

    This installs the apt repository, the current Moonshot GPG key, and a package that can update both. This is the preferred method of deploying repository information.

    Verifying the Moonshot GPG key

    If you wish to verify the Moonshot GPG key's validity and integrity, please see the Packaging GPG Key for further details.

  3. Update the apt cache with the new repository information:

    apt-get update

2. Install the Moonshot Client libraries

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

apt-get install moonshot

3. 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.