blob: 35a907929c18539d2cb9471493fe5bf88f61e4c6 [file] [log] [blame]
Nico Huberd6528722023-07-01 14:38:39 +00001Create environment files (cf. `git ls-files \*environment.template`):
2* Set SA_PUBLIC_DOMAIN_NAME in `environment`
Nico Hubera1a296f2023-06-25 10:07:07 +00003* Set CANONICAL_WEB_URL in `gerrit/environment`
Nico Huber54073102023-06-25 11:36:59 +00004* Enable GitHub OAUTH in `gerrit/environment`
Nico Huber59c365c2023-07-01 18:18:12 +00005
Nico Huberaa15aee2023-07-01 22:35:45 +00006To build:
7* nginx first because it creates selfsigned certificate `docker-compose build nginx`
8* then everything else `docker-compose build`
9
Nico Huber59c365c2023-07-01 18:18:12 +000010Get containers up:
11* `docker-compose up`
Nico Huber15edd772023-07-01 18:16:50 +000012
Nico Huber804b41b2023-07-02 15:53:42 +000013Mail setup:
14* A 'gerrit@' mail account will be added automatically
15* See `docker-compose exec mailserver setup` for more
16* Add account or alias for 'postmaster@'
17
Nico Huber15edd772023-07-01 18:16:50 +000018When the containers are up run `certbot`:
19* Once `docker-compose -f sa-certbot.yml run new`
20* Every x < 30 days `docker-compose -f sa-certbot.yml run renew`
21* Always reload nginx `docker-compose exec nginx nginx -s reload`
Nico Huber22aecea2023-07-19 01:39:58 +000022
23DKIM:
24* `docker-compose exec mailserver setup config dkim`
25* If using a subdomain, set `use_esld = false;`
26 in `mail/rspamd-override.d/dkim_signing.conf`
27* Publish key from `mail/config/rspamd/dkim/*.public.dns.txt` via DNS
Nico Hubered486d52023-07-19 14:00:59 +000028
29Mail testing with dial-in IP:
30Some popular (german) email providers greet with a 554 error when the IP is
31blacklisted. Seems out of standard and hence can lead to not bouncing the
32message immediately.
33* Set `smtp_skip_5xx_greeting = no` in `mail/config/postfix-main.cf`,
34 if you want immediate bounces.