Getting Started

.

1. DOWNLOAD

Download latest NikaMail distribution.

2. INSTALL

Run NikaMail installer and specify installation directory

    ~# chmod u+x ./nika_v1.run
    ~# ./nika_v1.run
    
   NikaMail 1.0 Installer

   Installation path [/opt/NikaMail]:
   Installing to /opt/NikaMail
   .
   Installed to /opt/NikaMail
   Installation complete.

Now cd to the installation directory:

   ~# cd /opt/NikaMail

Remove Postfix and other email servers installed by default

   ~# apt remove postfix

If you expect large number of e-mails with attachments we recommend to run it on a separate disk.

If you install it on Raspberry Pi we recommend to use a separate USB drive. Leave SD card to run system.

3. RUN WITH DOCKER

Install Docker on your system

    ~# apt install docker.io
    ~# systemctl start docker

Build image

    ~# make build

Run image

    ~# make start

RUN WITHOUT DOCKER

If docker isn’t available on your system you can run it manually or using supervisor.

REQUIREMENTS: 1. Java JDK 7+ 2. Linux/Mac or other POSIX system

Before running, recompile java extensions:

    ~# make build-java

Starting server

    ~# bin/jruby app/main.rb

Starting debug console

    ~# bin/jruby app/main.rb console
USING SUPERVISOR
  1. Rename config/supervisor.conf-template to config/supervisor.conf
  2. Edit config/supervisor.conf according to your server settings
  3. Include absolute path to config/supervisor.conf into you supervisor configuration.
  4. Restart supervisor