Public Repository

Last pushed: 2 years ago
Short Description
Magnet Message
Full Description

Magnet Message


Auxillary Deployment Commands

Prerequisite: Install Docker (1.6.x or 1.8 for Mac, 1.6.x for Windows, and the latest for Linux)

  1. To deploy on Linux (the user may be prompted for the password as it uses sudo by default)

    curl -sSL https://cdn.magnet.com/msd/latest/linux/deploy.sh | sudo bash
    
  2. To deploy on Mac and Windows

    Note: this assumes that you are using boot2docker with the default vm, named boot2docker-vm.

    curl -sSL https://cdn.magnet.com/msd/latest/vb/deploy.sh | bash
    
  3. To cleanup on Linux (the user may be prompted for the password as it requires sudo by default)

    curl -sSL https://cdn.magnet.com/msd/latest/cleanup.sh | sudo bash
    
  4. To cleanup on Mac and Windows

    curl -sSL https://cdn.magnet.com/msd/latest/cleanup.sh | bash
    

Note

If you would like to use a particular version instead of the latest, simply replace latest in the commands above with one of the tags. e.g.,

curl -sSL https://cdn.magnet.com/msd/1.6.3/linux/deploy.sh | sudo bash

What is Magnet Message?

Magnet Message is full-featured, open source mobile messaging software that allows developers to easily add messaging functionality to their mobile applications. Magnet Message is delivered as a ready-to-run server and native mobile SDKs for iOS and Android. Magnet Message is deployable in the cloud or on-premise and easily integrates with any app, existing system, or environment. For ease of administration, Magnet Message uses a web interface for configuration and management of the messaging server and reporting of in-app message and push notification delivery status.

Check out our great sample apps Soapbox and
Rock Paper Scissors Lizard Spock that are available for free on our downloads page.


What is in this Docker Image

Magnet Message standalone distribution (mmx-standalone-dist-<version>.zip). For other downloads, please visit magnet.com


Connecting the Sample Apps to the container

Once you have the container launched, you may want to try out the Quickstart app and other sample apps. Quickstart and the other samples are available inside the console (please see the instructions printed out by the auxillary curl commands about the console) and here as well: Getting Started on Android, Getting Started on iOS. Similiar to other Docker apps, you need to use the host's ip address as well as the forwarded ports. In the case of Mac and Windows, you need to use the host's mapped port of 5222 (49985) and 5220 (49983) (they are being printed out by the auxillary curl commands). So, here is the extra step to do before connecting to the Message server:

(we use Quickstart as an example here while it is very similiar for the other apps)

For Android:

  1. Open quickstart.properties in app/src/main/res/raw
  2. Set the value of host to the host's ip address
  3. For container running on Mac and Windows, set the value of port to 49985 (the host-mapped port of 5222).

For iOS:

  1. Open Configurations.plist in QuickStart/Supporting Files
  2. Expand Root and then default
  3. Set the value of BaseURL to mmx://<your host ip>:5222. For Mac and Windows, set the value of BaseURL to mmx://<your host ip>:49985 (the host-mapped port of 5222)

Running the iOS sample apps

By default, the sample apps are set to use TLS, while the server in this image is not pre-configured to use it; thus, in order to try out the iOS sample apps, please follow these instructions:

  1. Open Configurations.plist in QuickStart (or the name of the other samples)/Supporting Files
  2. Expand Root and then default
  3. Set ShouldForceTLS to No
  4. Build and run the app.

For support and issues, please visit helpcenter.magnet.com.

Docker Pull Command
Owner
magnetsystems