SMSGW SMS management system

SMSGW is open source web-based SMS (Short Message Service) management system, it use gammu-smsd (part of gammu family) as SMS gateway engine to deliver and retrieve messages from your phone/modem.

NOTICE: still in active development as part of the master thesis

Requirements

docker >= 1.9.0
docker-compose >= 1.5.2
for deployment and provisioning
- ansible >= 1.8.2
for development
- node.js >= 5.1.0
- gulp >= 3.9.0
  - npm install -g gulp

Getting started

# cloning repository
git clone git@github.com:VojtechBartos/smsgw.git
cd smsgw

# creating .env file with environment variables and replacing placeholders
cp .env.sample .env
vim .env

# running app
make dev # for dev environment with container output
# OR
make # for production env in background

Provisioning fresh new server

You need to have prepared fresh new machine with SSH access and IP address

# copy sample host file
cp provisioning/hosts.sample provisioning/hosts

# update host file with SSH user, IP address and domain/hostname of machine
vim provisioning/hosts

# copy sample vars file for SMSGW project
cp provisioning/groups_vars/smsgw/service.yml.sample provisioning/groups_vars/smsgw/service.yml

# update vars file for SMSGW project with your env variables for production,
# new DB and RabbitMQ will be created
vim provisioning/groups_vars/smsgw/service.yml

# run ansible provisioning which will prepare and start SMSGW project on your machine
make deploy

# open browser on hostname, if your DNS pointing to right machine you should
# see SMSGW sign in page

Issues

What if i am using VPS in VirtualBox?
- Make sure that you have installed VirtualBox Quest Additions. tutorial
I am not able to see GSM modem in /dev
- Follow this tutorial

TODO's

Documentation
Better tests coverage
Make final JS bundle smaller
Packages
- upgrade react-router
- upgrade react-tagsinput
Functionality
- ~~verifying passwords during change in settings and admin page~~
DevOps
- ~~write installation steps~~
- replace vojtechbartos/nginx with https://github.com/jwilder/nginx-proxy
- add flower monitoring
- ~~build image on CircleCI and pushing to Docker Hub via rarous~~
- after success push to Docker Hub run ansible provisioning script to deploy and update server

VojtechBartos / smsgw