pimentaCHAT

Welcome

pimentaCHAT

Deploy pimentaCHAT to Linux that run on systemd (RedHat, Centos, Ubuntu, CoreOS and so on).

Prerequisite

You need to have docker installed.

How to run pimentaCHAT on systemd

  1. Create a docker network docker network create pimentachat_default
  2. Create two service files: mongo.service and pimentachat.service
  3. Enable the service files
  4. Run the mongo.service
  5. Create the mongo-init-replica to enable opolog
  6. Run the pimentachat.service

If you reboot the server, the services will start automatically in the right order.

Service Files

mongo.service:

[Unit]
Description=mongo
Requires=docker.service
After=docker.service

[Service]
EnvironmentFile=/etc/environment
User=dockeruser
Restart=always
TimeoutStartSec=0
ExecStartPre=-/usr/bin/docker kill mongo
ExecStartPre=-/usr/bin/docker rm mongo
ExecStartPre=-/usr/bin/docker pull mongo:3.2


ExecStart=/usr/bin/docker run \
    --name mongo \
    -v .../path/to/data/db:/data/db \
    -v .../path/to/data/dump:/data/dump \ <--optional
    --net=pimentachat_default \
    mongo:3.2 \
    mongod --smallfiles --oplogSize 128 --replSet rs0 --storageEngine=mmapv1

ExecStop=-/usr/bin/docker kill mongo
ExecStop=-/usr/bin/docker rm mongo

pimentachat.service:

[Unit]
Description=pimentachat
Requires=docker.service
Requires=mongo.service
After=docker.service
After=mongo.service

[Service]
EnvironmentFile=/etc/environment
User=dockeruser
Restart=always
TimeoutStartSec=0
ExecStartPre=-/usr/bin/docker kill pimentachat
ExecStartPre=-/usr/bin/docker rm pimentachat
ExecStartPre=-/usr/bin/docker pull pimentachat/pimenta.chat:latest

ExecStart=/usr/bin/docker run \
    --name pimentachat \
    -v .../path/to/uploads:/app/uploads \
    -e MONGO_OPLOG_URL=mongodb://mongo:27017/local \
    -e MONGO_URL=mongodb://mongo:27017/pimentachat \
    -e ROOT_URL=https://sub.domain.xx \
    --link mongo:mongo \
    --net=pimentachat_default \
    --expose 3000 \
    pimentachat/pimenta.chat:latest

ExecStop=-/usr/bin/docker kill pimentachat
ExecStop=-/usr/bin/docker rm pimentachat

Build the mongo-init-replica container (only run once)

Execute:

docker run \
      --name mongo-init-replica \
      --link mongo:mongo \
      --rm \
      --net=pimentachat_default \
      mongo:3.2 \
      mongo mongo/pimentachat --eval "rs.initiate({ _id: 'rs0', members: [ { _id: 0, host: 'localhost:27017' } ]})"

Reverse Proxy

If you are running a reverse proxy make sure it is joining the pimentachat_default network. Add ExecStartPre=-/usr/bin/docker network connect pimentachat_default Nginx to the pimentachat.service if you Proxy container is named Nginx and be sure to configure it correctly.

If you choose to use a non-dockerized nginx as a reverse proxy, please not that you then have to add -p your-host-port:3000 to the ExecStart command of pimentachat.service and then configure your vhost to pass to your-host-port.

Backup

All data will be hourly backed up to /data/domains/example.org/data folder. We advise to copy this folder to a remote location in case of hardware failure.

Questions

If you have any questions, don’t hesitate to open issues.

Bitbucket Contribute to our growth with your feedback