how can i create a docker-compose to start

pedroricardo · March 4, 2023, 3:54pm

i need to create a complete docker-compose
just to give docker-compose up -d on my server and have access to modules on port 8080 for example

trustedcomputer · March 4, 2023, 6:01pm

Here’s a good place to start:

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

More examples and info are linked to under the production header:

pedroricardo · March 4, 2023, 6:37pm

I tried to connect, but I couldn’t add the health module when the erp runs with docker

trustedcomputer · March 4, 2023, 8:11pm

That’s because in v14, Healthcare was spun off into its own app, so it’s no longer part of ERPNext proper. You would run into this in a traditional install as well, having to get the app and install it into your site. So you can follow the instructions following the “Custom App” link in those production options I linked to for the docker way of doing this.

Or, if you want to run v13, you can modify your docker-compose.yml for v.13 and just check a box to turn on that domain.

pedroricardo · March 4, 2023, 8:28pm

that was the problem, can you provide me with a docker-compose where I can connect this health module alone with docker-compose and that’s what I need

trustedcomputer · March 4, 2023, 8:37pm

Using version 13, you would just go through the same process of creating your docker-compose.yml according to the instructions. Then before starting it with docker compose up -d, modify the image fields for each service from the version 14 release listed to the version 13 release you want in docker-compose.yml.

EDIT: It’s much easier to change “ERPNEXT_VERSION=” in your env file first, then you don’t have to change it in multiple places in your docker-compose.yml.

If version 14, you have to build custom image to have healthcare.

revant_one · March 4, 2023, 9:31pm

for custom app / hr app you’ll need custom image

gsarunk · March 5, 2023, 3:55am

For custom app, fork GitHub - castlecraft/custom_containers. This is by far the easiest way i know to build custom image

change apps.json and include your app.

Change the build.env to your need at least the PROJECT_NAMESPACE

version.txt optional

Finally commit and watch for actions to complete.

pedroricardo · March 7, 2023, 3:17pm

Can you help me by sending me a generic docker-compose ready with erpnext 13 and the health module activated

so I can just change the database password and then use docker-compose up -d and have the system online locally?

my native language is not english and i’m having trouble connecting this system

trustedcomputer · March 7, 2023, 11:05pm

You are thinking more in terms of how virtual machine templates work and are distributed, not docker terms. There is no generic docker-compose file, you generate it yourself depending on which services and options you need, see this document: frappe_docker/setup-options.md at main · frappe/frappe_docker · GitHub

If you are having trouble with the instructions in the link above, you may want to check this post out instead, where it links to a generic VM and instructions to have a working ERPNext site in just a few steps: Unofficial frappe & ERPNext Virtual Machine for v11 to v14