NowSMS NextGen Quick Install

NowSMS NextGen is an SMS Gateway, MMS Gateway and MMSC for Unix-based environments. NowSMS is a server application that is designed to run in the background and always be active. The installation process requires a login with root/admin privileges.

The initial NowSMS NextGen releases are supporting two environments:

1.) Linux AMD64 for 64-bit Intel/AMD architecture, compatible with Debian, Red Hat, Ubuntu, CentOS and Mint.

2.) Apple macOS x64, Catalina or Big Sur releases recommended,

Linux Installation Instructions

The instructions for installing NowSMS on Linux depend on whether you have full desktop access (graphical interface), or terminal access (text based) via ssh or similar.

Linux Install: Full Desktop Access (graphical interface)

Step 1: Login to Linux with a user account that has root/admin privileges.

Step 2: Follow the link to download https://www.nowsms.com/download/linux/nowsms.tar.gz from a web browser. (If a web browser is not installed, install one now, or use the remote terminal install instructions, which can also be used via a local terminal window.)

Step 3: Open nowsms.tar.gz with an archive manager, and extract the file NowSMSInstall. This process will vary with different operating system versions, but is often a simple process as shown in these screen capture images:

Step 4: In most environments, it is possible to double click NowSMSInstall to start the installation.

(If you are unable to start NowSMSInstall in this way, open a terminal window, and use the cd command to change to the directory containing this file. Type ./NowSMSInstall and press Enter.)

Step 5: NowSMSInstall will open a window in the web browser to continue.

The default directory locations are appropriate for most installations:

Program files will be installed in /usr/local/bin

Data files will be stored in /var/lib/nowsms

After clicking on the “Install Service” button, in some environments, NowSMS might prompt for the root/admin password, if the system requires it to complete the service installation.

Step 6: If this is a new installation, the System Configuration menu will be displayed. For information on the next steps, skip ahead to the section of this document titled Quick Start Configuration.

Linux Install: Terminal Access (text-based interface)

Step 1: Open a terminal session, and ensure that you are logged in with a user account that has root/admin privileges.

Step 2: Download NowSMS with the following command:

curl https://www.nowsms.com/download/linux/nowsms.tar.gz -o nowsms.tar.gz

If curl is not installed, use the following command to install this tool:

sudo apt-get update

sudo apt install curl

Step 3: Extract the installation program, NowSMSInstall with the following command:

tar -xzf nowsms.tar.gz

Step 4: Start the installation with the following command:

./NowSMSInstall

Step 5: If NowSMS was previously installed, options might be displayed to update the existing install or remove the service. For a new installation, press the “I” key to install NowSMS.

Program files will be installed in /usr/local/bin

Data files will be stored in /var/lib/nowsms

In some environments, NowSMS might prompt for the root/admin password, if the system requires it to allow the service installation.

Before exiting, NowSMSInstall will display instructions for completing the installation by connecting with a web browser and using a temporary password, similar to this example:

To complete installation remotely, connect to http://192.168.0.109:8800, and login with username admin and temporary password 98C1CF240500

NowSMS defaults to using port 8800 for the web interface. If another application is already using this port, a different port number might be displayed. If you are unable to connect to this port, it may be necessary to open this port in the Linux system firewall. If you wish to use a different port, it is possible to change this later via the web-based configuration interface, or by manually editing /var/lib/nowsms/SMSGW.INI.

After logging in to this website, the System Configuration menu will be displayed. For information on the next steps, skip ahead to the section of this document titled Quick Start Configuration.

macOS Install: Full Desktop Access (graphical interface)

Step 1: Login to macOS with a user account that has root/admin privileges.

Step 2: Follow the link to download https://www.nowsms.com/download/macos/nowsms.tar.gz from a web browser.

Step 3: Open the “Downloads” folder in Finder, and locate nowsms.tar or nowsms.tar.gz. Double click on this file to extract NowSMSInstall.

Step 4: Double click on NowSMSInstall, which will result in an error.

Step 5: Open “System Preferences”, then select “Security & Privacy”. If necessary, switch to then “General” tab. A message will be displayed indicating that NowSMSInstall was blocked. Select “Open Anyway”, and then confirm this action, if required.

Step 6: NowSMSInstall will open a window in the web browser to continue.

The default directory locations are appropriate for most installations, and are recommended for Unix-style services:

Program files will be installed in /usr/local/bin

Data files will be stored in /var/lib/nowsms

After clicking on the “Install Service” button, NowSMS will prompt for the root/admin password, if the system requires it to complete the service installation.

Step 7: If this is a new installation, the System Configuration menu will be displayed. For information on the next steps, skip ahead to the section of this document titled Quick Start Configuration.

Quick Start Configuration

There are two configuration tasks that must be completed before NowSMS can provide any functionality:

  • At least one admin user account must be defined. Otherwise, anyone can access the admin configuration pages, connecting either via the localhost web interface, or using the temporary password generated by a terminal access based install.
  • An SMSC connection must be configured.

When connecting to the NowSMS, these conditions are flagged at the top of the “System Configuration” page.

Press the “Create SMS Account” button to define a user account, and ensure that “Enable Admin Access via Web” is enabled for the account. To avoid potential future confusion, we recommend either unchecking “Enable Credit Balance” or adding some credits to this account during this creation process, so that the user will be able to send SMS messages when an SMSC connection is added.

 

After defining an admin account, you will be directed to a login screen, requiring you to login to continue configuring NowSMS.

After logging in, if you are taken to a page other than “System Configuration”, use the menu to return to the “System Configuration” page.

An SMSC connection is required to be able to send and/or receive SMS messages with NowSMS. When you press the “Add SMSC Connection” button, a choice of supported SMSC connection types is displayed.

Until this document is updated, more information on these SMSC connection types can be found in the documentation for the Windows version of NowSMS: Configuring SMSC Connections

For support or questions, contact us, or visit our Support Forum Website.