Note: MemberMatters only supports running in Docker on Linux. Installing Docker is outside the scope of this guide, please consult your favourite search engine for tips.
To get started, download the latest version from docker hub using the following command:
docker pull membermatters/membermatters
Create a file to contain all of your environment variables. This file contains sensitive information so treat it like a
password! Place it somewhere you won’t forget like
/usr/app/env.list. This file is where Docker gets the environment
Once you’ve downloaded the docker image and configured your environment variables, you’ll need to create a container:
docker create -p 8000:8000 --name membermatters --restart always --env-file /usr/app/env.list -v /usr/app/:/usr/src/data membermatters/membermatters
After you’ve created the container you can start/stop/restart it with:
docker start membermatters docker stop membermatters docker restart membermatters
Once your container is running, you will be able to login with the default admin account details:
Email: [email protected] Password: MemberMatters!
The first thing you should do is change the email address and password of the default admin account.
Once you’ve done this, your MemberMatters instance is ready for configuration. You should now head to post installation steps for important instructions on setting up and customising your instance.
Docker containers are meant to be disposable, so you’ll need to delete it and make a fresh one from the latest image. We suggest writing a bash script like the one below:
echo "checking for new docker image" docker pull membermatters/membermatters echo "Stopping the docker container" docker stop membermatters echo "Removing the old docker container" docker rm membermatters echo "Creating new docker container" docker create -p 8000:8000 --name membermatters --restart always --detach --env-file /usr/app/env.list -v /usr/app/:/usr/src/data membermatters/membermatters echo "Running new docker container" docker start membermatters
MemberMatters also offers a kiosk mode. You can build this by running
API_BASE_URL=https://portal.example.org npm run build:electron after reading through the development instructions in the
frontend folder. At this time, we do not offer precompiled binaries for download.
This command will compile an electron based application that you can run on a machine set up as a kiosk. We recommend that you run the build command on the machine you intend to use as a kiosk to reduce compatibility problems due to different OS versions and/or architectures. For security reasons, kiosk builds will only have limited profile functionality and are primarily meant to allow members to sign in/out of site and use basic features of MemberMatters. Be sure to specify the full URL to your MemberMatters instance, including the protocol (http or https).
The first time a kiosk connects, you will have to “authorise” it from the MemberMatters dashboard. You should see the kiosk show up with it’s serial number. Open the kiosk to edit it, then click on authorise to allow full functionality. This is to prevent “random” kiosks being able to connect to your MemberMatters instance.
You may need to install ffmpeg and a chromium run time.