prosody's Introduction

Prosody

From 616.pub. Using the following steps to setup a self-hosted jabber server.

0. Requirements

A linux server with docker installed
- As low as 1 core, 512MB memory
A domain under your control
A pair of hCaptcha keys filter spamming in register page

1. Define some varibles

# You need a domain
DOMAIN=yourdomain.com
# Your jabber account on that server, will be created as admin.
JID="yourname@${DOMAIN}"
# hCaptcha keys
CAPTCHA_PRIVATE=xxx
CAPTCHA_PUBLIC=yyy

2. DNS configure

Suppose your server IP is 1.2.3.4, the following records should be set ( replace DOMAIN with your real domain name):

;; A Records
DOMAIN.	1	IN	A	1.2.3.4

;; CNAME Records
room.DOMAIN.	1	IN	CNAME	DOMAIN.
upload.DOMAIN.	1	IN	CNAME	DOMAIN.

;; SRV Records
_xmpp-client._tcp.DOMAIN.	1	IN	SRV	0 5 5222 DOMAIN.
_xmpps-client._tcp.DOMAIN.	1	IN	SRV	0 5 5223 DOMAIN.
_xmpps-client._tcp.DOMAIN.	1	IN	SRV	5 0 443 DOMAIN.
_xmpp-server._tcp.DOMAIN.	1	IN	SRV	0 5 5269 DOMAIN.

3. Obtain domain SSL certs

mkdir -p acme.sh
docker volume create --driver local --opt type=none --opt device=$PWD/acme.sh --opt o=bind acme.sh
docker run -it --rm --name acme.sh -p 80:80 -v acme.sh:/root/.acme.sh ghcr.io/ichuan/prosody \
  /root/.acme.sh/acme.sh --home /root/.acme.sh --issue --standalone \
  --server letsencrypt -d $DOMAIN -d upload.$DOMAIN

Certs will be renewed automatically.

4. Running

# database
mkdir prosody

# datetime when this server goes live
SINCE="2018/9/2"

# ports: 5223:legacy_ssl, 80:http, 443:https, 5000:proxy65, 5222:c2s, 5269:s2s
docker run --restart always -itd --name iprosody \
  -p 5222:5222 -p 5223:5223 -p 5269:5269 -p 80:80 -p 443:443 -p 5000:5000 \
  -v $PWD/prosody:/var/lib/prosody \
  -v acme.sh:/root/.acme.sh \
  -e ADMIN_JID=$JID -e DOMAIN=$DOMAIN -e SINCE=$SINCE \
  -e CAPTCHA_PRIVATE=$CAPTCHA_PRIVATE \
  -e CAPTCHA_PUBLIC=$CAPTCHA_PUBLIC \
  ghcr.io/ichuan/prosody

Now, head to https://DOMAIN to see it.

5. Maintenance

# Create your admin JID
docker exec -it iprosody prosodyctl adduser $JID
# or via web: https://${DOMAIN}/register

6. Upgrading

docker pull ghcr.io/ichuan/prosody
docker stop iprosody && docker rm iprosody
# re-run with previous command line
docker run --restart always ...

prosody's People

Contributors

Stargazers

Watchers

prosody's Issues

How to properly maintain this docker instance if I want to change prosody configuration?

@ichuan Thanks for your work and for sharing this project publicly!

I have a question regarding changes in configuration files. How do I update and restart the docker image having removed certain modules from configuration?

Recommend Projects