An open API service indexing awesome lists of open source software.

https://github.com/geniusdynamics/ns8-erp-next

ERPnext Module for Nethserver 8 Free and Open Source Enterprise Resource Planning (ERP)
https://github.com/geniusdynamics/ns8-erp-next

Last synced: 3 months ago
JSON representation

ERPnext Module for Nethserver 8 Free and Open Source Enterprise Resource Planning (ERP)

Awesome Lists containing this project

README

        

# ns8-erpnext

## Install

Instantiate the module with:

```shell
add-module ghcr.io/geniusdynamics/erpnext:latest 1
```

The output of the command will return the instance name.
Output example:

{"module_id": "erpnext1", "image_name": "erpnext", "image_url": "ghcr.io/geniusdynamics/erpnext:latest"}

## Configure

Let's assume that the mattermost instance is named `erpnext1`.

Launch `configure-module`, by setting the following parameters:
- `host`: a fully qualified domain name for the application
- `http2https`: enable or disable HTTP to HTTPS redirection (true/false)
- `lets_encrypt`: enable or disable Let's Encrypt certificate (true/false)

Example:

```
api-cli run configure-module --agent module/erpnext1 --data - <80/tcp 80b8de25945f-infra
d8df02bf6f4a docker.io/library/mariadb:10.11.5 --character-set-s... 9 minutes ago Up 9 minutes 127.0.0.1:20015->80/tcp mariadb-app
9e58e5bd676f docker.io/library/nginx:stable-alpine3.17 nginx -g daemon o... 9 minutes ago Up 9 minutes 127.0.0.1:20015->80/tcp erpnext-app
```

you can see what environment variable is inside the container
```
podman exec erp-next-app env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
TERM=xterm
PKG_RELEASE=1
MARIADB_DB_HOST=127.0.0.1
MARIADB_DB_NAME=erpnext
MARIADB_IMAGE=docker.io/mariadb:10.11.5
MARIADB_DB_TYPE=mysql
container=podman
NGINX_VERSION=1.24.0
NJS_VERSION=0.7.12
MARIADB_DB_USER=erpnext
MARIADB_DB_PASSWORD=erpnext
MARIADB_DB_PORT=3306
HOME=/root
```

you can run a shell inside the container

```
podman exec -ti erpnext-app sh
/ #
```
## Testing

Test the module using the `test-module.sh` script:

./test-module.sh ghcr.io/nethserver/erpnext:latest

The tests are made using [Robot Framework](https://robotframework.org/)

## UI translation

Translated with [Weblate](https://hosted.weblate.org/projects/ns8/).

To setup the translation process:

- add [GitHub Weblate app](https://docs.weblate.org/en/latest/admin/continuous.html#github-setup) to your repository
- add your repository to [hosted.weblate.org]((https://hosted.weblate.org) or ask a NethServer developer to add it to ns8 Weblate project