License

Copyright (C) 2008-2021 Oliver Bohlen.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

A copy of the license is included in the section entitled "GNU Free Documentation License".

Introduction

This documentation comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.

Howto: Instand Messaging alternative Jabber for Gentoo Linux

In times of blackboxed/centralized/clouded "Instand Messagig" services with possibly bad security/encryption like WhatsApp & co. I would like to use my own Instand Messaging Service with data hold encrypted on my own Server. Here is the way I do it.
As an snartphone app for this service I suggest the App called "Conversations"

If you want to use this solution you need the following howto(s) finished:

Required software

The required software has to be installed with the following command(s):
emerge net-im/ejabberd

Changes in /etc/jabber/ejabberd.yml

File permissions:
Owner: root
Group: jabber
Permissions: -rw-r-----

Click here for a download of the complete file: /etc/jabber/ejabberd.yml

Changed on 09.11.15
Issued by olli
Beginning line 18

The Hostname(s) of the Server


Before change
 - localhost
After change
  - "example.com"

Changed on 09.11.15
Issued by olli
Beginning line 28

SSL-Encryption Chat Clients


Before change
 - /etc/ssl/ejabberd/server.pem
After change
  - /etc/ssl/example.com/example.com.pem

Changed on 09.11.15
Issued by olli
Beginning line 37

Listen ipv4


Before change
  ip: "::"
After change
    ip: "0.0.0.0"

Changed on 09.11.15
Issued by olli
Beginning line 47

SSL-Encryption Chat Clients

    starttls: true

Changed on 09.11.15
Issued by olli
Beginning line 53

Listen ipv4


Before change
  ip: "::"
After change
    ip: "0.0.0.0"

Changed on 09.11.15
Issued by olli
Beginning line 62

Listen ipv4


Before change
  ip: "::"
After change
    ip: "0.0.0.0"

Changed on 09.11.15
Issued by olli
Beginning line 78

Listen ipv4


Before change
  ip: "::"
After change
    ip: "0.0.0.0"

Changed on 09.11.15
Issued by olli
Beginning line 96

Listen ipv4


Before change
  ip: "::"
After change
    ip: "0.0.0.0"

Changed on 09.11.15
Issued by olli
Beginning line 104

SSL-Encryption other Jabber Servers


Before change
s2s_use_starttls: optional
After change
s2s_use_starttls: required

Changed on 09.11.15
Issued by olli
Beginning line 110

The Admin-User


Before change
auth_method: internal
After change
auth_method: pam
pam_service: "system-auth"
pam_userinfotype: "username"

Changed on 09.11.15
Issued by olli
Beginning line 119

The Admin-User

  admin:
      user:
            - "admin": "example.com"

Setting up services

For starting the new service after system reboot you should add it to a runlevel with the following command(s):

rc-update add ejabberd default

Please send a feedback to: doc<at>gabosh.net

Howto listing
File Index

Here you can find the official Gentoo Linux Forums where you can find a lot of answers.

Here a link to the official Gentoo Linux Homepage.

Edit Howto

About / Impressum

Click here for About / Impressum

Wishlist

If you want to support my work you can find my Amazon whishlist here