DNS based setup in Docker environment for multitenancy

mmwaseem · January 9, 2024, 11:49pm

I setup two sites site1.example.com and site2.example.com on bare metal servers. using DNS based multitenancy and NGINX successfully.

When I was trying to achieve this same setup using docker & easy-install (frappe_docker), I’m stuck & don’t know how to achieve it?

After running easy install with the following commands

wget https://raw.githubusercontent.com/frappe/bench/develop/easy-install.py
python3 easy-install.py --prod --email <myname@example.com> --sitename <site1.example.com>

Docker and it’s containers are running, site1.example.com site is up and running too.

Then I tweaked frappe-compose.yml file to add another site

labels:
      traefik.enable: "true"
      traefik.http.routers.frontend-http.entrypoints: websecure
  ->  traefik.http.routers.frontend-http.rule: Host(`site1.example.com`, `site2.example.com`)
      traefik.http.routers.frontend-http.tls.certresolver: main-resolver
      traefik.http.services.frontend.loadbalancer.server.port: "8080"

Ran the following command for site2

python3 easy-install.py --prod --email <myname@example.com> --sitename <site2.example.com>

Now my both sites are accessible from browser.

But both sites are sharing common frappe/apps folder.

At this point I don’t know how to add the additional sites while keeping those sites folders seprately.

dkoryto · January 10, 2024, 11:42am

easy-install.py will not support multisite.

github.com

frappe/frappe_docker/blob/main/docs/port-based-multi-tenancy.md

WARNING: Do not use this in production if the site is going to be served over plain http.

### Step 1

Remove the traefik service from docker-compose.yml

### Step 2

Add service for each port that needs to be exposed.

e.g. `port-site-1`, `port-site-2`, `port-site-3`.

```yaml
# ... removed for brevity
services:
	# ... removed for brevity
  port-site-1:
    image: frappe/erpnext:v14.11.1
    deploy:
      restart_policy:

This file has been truncated. show original

mmwaseem · January 10, 2024, 9:13pm

github.com

frappe/frappe_docker/blob/main/docs/single-server-example.md

### Single Server Example

In this use case we have a single server with a static IP attached to it. It can be used in scenarios where one powerful VM has multiple benches and applications or one entry level VM with single site. For single bench, single site setup follow only up to the point where first bench and first site is added. If you choose this setup you can only scale vertically. If you need to scale horizontally you'll need to backup the sites and restore them on to cluster setup.

We will setup the following:

- Install docker and docker compose v2 on linux server.
- Install traefik service for internal load balancer and letsencrypt.
- Install MariaDB with containers.
- Setup project called `erpnext-one` and create sites `one.example.com` and `two.example.com` in the project.
- Setup project called `erpnext-two` and create sites `three.example.com` and `four.example.com` in the project.

Explanation:

Single instance of **Traefik** will be installed and act as internal loadbalancer for multiple benches and sites hosted on the server. It can also load balance other applications along with frappe benches, e.g. wordpress, metabase, etc. We only expose the ports `80` and `443` once with this instance of traefik. Traefik will also take care of letsencrypt automation for all sites installed on the server. _Why choose Traefik over Nginx Proxy Manager?_ Traefik doesn't need additional DB service and can store certificates in a json file in a volume.

Single instance of **MariaDB** will be installed and act as database service for all the benches/projects installed on the server.

Each instance of ERPNext project (bench) will have its own redis, socketio, gunicorn, nginx, workers and scheduler. It will connect to internal MariaDB by connecting to MariaDB network. It will expose sites to public through Traefik by connecting to Traefik network.

This file has been truncated. show original

Thanks

Robot · January 22, 2024, 6:15am

Hi @mmwaseem, May I know How did you achieve this, Do you have any documentations for that if yes please share, It’d really be helpful
Thanks

mmwaseem · February 16, 2024, 1:10pm

By following this tutorial & the related chapters in the documentation I was able to setup DNS based multitenancy:

https://frappeframework.com/docs/user/en/bench/guides/setup-multitenancy

Along with the installation of NGINX, Supervisor & Let’s Encrypt.