How to Install Docker

Follow the instructions here: https://docs.docker.com/get-docker/

Acquire/Configure Credentials


# system setting
export DOCKERIZED=true

# if use AWS algorithm, then you must use a static IP address
export LOCAL_ALGORITHM=true
export HOST_IP=<your host IP address>
export HOME=<your path on host machine>
export BUCKET_NAME=macroscope-smile

# create mounted volumes on host machine
mkdir -p ${HOME}/smile_data
mkdir -p ${HOME}/smile_data/${BUCKET_NAME}
mkdir -p ${HOME}/smile_user
mkdir -p ${HOME}/smile_tag

# email notification (To enable notification, uncomment below and put down valid email server information) 
# export EMAIL_HOST=
# export EMAIL_PORT=
# export EMAIL_FROM_ADDRESS=
# export EMAIL_PASSWORD=

# put down your own RANDOM keys at least 8 digits;
# if wish to align with your AWS deployment, please put down AWS access key and secret (Not required if LOCAL_ALGORITHM=true) 
export AWS_ACCESSKEY=AAAAAAAAAAAAAAAAAAAAA
export AWS_ACCESSKEYSECRET=BBBBBBBBBBBBBBBBBBBBBBBBBB

# social media platforms
export REDDIT_CLIENT_ID=
export REDDIT_CLIENT_SECRET=
export TWITTER_CONSUMER_KEY=
export TWITTER_CONSUMER_SECRET=

# export
export BOX_CLIENT_ID=
export BOX_CLIENT_SECRET=
export DROPBOX_CLIENT_ID=
export DROPBOX_CLIENT_SECRET=
export GOOGLE_CLIENT_ID=
export GOOGLE_CLIENT_SECRET=

# start
docker-compose -f docker-compose-smile.yml up

# stop
# docker-compose -f docker-compose-smile.yml down -v

Note:

How to run

All images have been pushed to Docker Hub. All you need is the YAML configuration file to run.

You must Download

compose yaml file here:

To Start

run the prewritten shell script:

sh docker-command-smile.sh

or

export all environment variables and then

docker-compose -f docker-compose-smile.yml up

Then you should be able to access SMILE at http://<your IP address>:8001

To Stop

docker-compose -f docker-compose-smile.yml down -v

Update

docker-compose -f docker-compose-smile.yml pull


Appendix:

SMILE and BAE images on Docker Hub

https://hub.docker.com/orgs/socialmediamacroscope/repositories

Architectures

Docker vs Hubzero Tool mode

export DOCKERIZED=true → Dockerized version
export DOCKERIZED=false → Hubzero Tool version, can be run by command npm start