Added more detailed step-by-step instructionsfor those unfamiliar with docker and/or frappe

Linden Crandall 2025-01-11 20:56:49 +00:00
parent d9188239af
commit db09e0cf35

@ -3,18 +3,36 @@ Currently used compose file: `/root/frappe-compose.yml`
Restart server: `sudo docker compose -f /root/frappe-compose.yml up -d` Restart server: `sudo docker compose -f /root/frappe-compose.yml up -d`
#### Change DNS name #### Change DNS name
- Change directory name inside the `frontend` container `sites` folder and default site in `sites/common_site_config.json` - Open a shell session within the `frontend` container: `sudo docker exec -it frontend /bin/bash`
- Change name in `/root/frappe-compose.yml` and restart server
- Edit `sites/common_site_config.json` file and change the "default_site" value to new hostname i.e. "erpnext.lasthourhosting.org"
- If it exists, change the website folder name at `/sites/<OLDSITENAME>` to `/sites/<NEWSITENAME> i.e.:
`mv /sites/erp.sprinklersnorthwest.com /sites/erpnext.lasthourhosting.org`
- Exit shell session within `frontend` container
- Change name in `/root/frappe-compose.yml` under the `frontend` service's `labels` section and restart server:
```
labels:
- traefik.enable=true
- traefik.http.services.frontend.loadbalancer.server.port=8080
- traefik.http.routers.frontend-http.entrypoints=websecure
- traefik.http.routers.frontend-http.tls.certresolver=main-resolver
- traefik.http.routers.frontend-http.rule=Host(`erpnext.lasthourhosting.org`)
```
#### IPv6 Support (from https://docs.docker.com/engine/daemon/ipv6/) #### IPv6 Support (from https://docs.docker.com/engine/daemon/ipv6/)
- Edit `/etc/docker/daemon.json` to contain (then `systemctl restart docker`): - Edit staging server's `/etc/docker/daemon.json` to contain:
``` ```
{ {
"ipv6": true, "ipv6": true,
"fixed-cidr-v6": "2001:db8:1::/64" "fixed-cidr-v6": "2001:db8:1::/64"
} }
``` ```
- Edit compose file to look something like: - then `systemctl restart docker`
- Edit the frappe-compose file.yml file's networks section to look something like:
``` ```
networks: networks:
default: default:
@ -23,7 +41,7 @@ networks:
config: config:
- subnet: 2001:db8::/64 - subnet: 2001:db8::/64
``` ```
- Edit traefik container to hard-code IPv6 addresses for ACME: - Edit the traefik container to hard-code IPv6 addresses for ACME (in frappe-compose.yml under the proxy service):
``` ```
extra_hosts: extra_hosts:
- "acme-staging-v02.api.letsencrypt.org:2606:4700:60:0:f41b:d4fe:4325:6026" - "acme-staging-v02.api.letsencrypt.org:2606:4700:60:0:f41b:d4fe:4325:6026"