ERPNEXT: The most agile ERP on the planet in NS8

oneitonitram · August 7, 2024, 8:32pm

You guys Said NS8 is a Business Platform, So lets make it One

After Months of Searching and testing Multiple ERP systems.
After 6 Months of Learing, Building, Testing, Tinkering and so many Servers crashed. We are HAppy to Present the Availability of ERPNEXT from Frappe In Nethserver 8

ERPnext IS Aguably the Most Robust Opensource ERP System, Extensible and Truly Opensource

While A Robust, Extensible and Scalable solution, it is also one of the Most Difficult ERP system to Deploy for Production, even the developers agree to this, And it was even more Difficutl to get it running on Nethserver 8. It was a Worth While Venture.

Most and Additional components and Information on ERPnext and FrappeFramework can be found here Frappe (github.com)

INSTALLATION
BEgin By Installing Our Genforge Repository with Instructions here

(You must Enable the Testing Repo to Test this App at the Moment)

Locate ERPnext from the Software Center and Install.
After Installation, configure your hostname

Wait Afew Seconds, and you should be able to access ERPNExt from the Defined FQDN

Default Username and Password

Username: Administrator
Password: admin
You should be presented with a Setup Wizard

image567×515 16.7 KB

image590×555 32.3 KB

IF All Goes Well, You should have your Initial Dashboard Ready

Going Through the Features and Functions Available is beyond this Announcement.

PS

Do not use this Solution if you Have a Very Small Team in your Organization, with Few Moving Parts.
The configurations Alone, Let Alone the Feature Set might Drive you Nuts
This is a great Solution for if you Need Massive Scale In ERP

SOme Commands to Manager ERPNext After Installation
Reference of Available Commands
Commands Reference (frappeframework.com)

MarketpLace of SOme of the Apps you can Install frappecloud.com/marketplace

ToDo
Some Notes on what is to be done

ToDo

Figure out the best way To Pre-implement Frappe insights

Frappe Insights Introduction: https://www.youtube.com/watch?v=2IprbndE9T0

Frappe Insights v3 demo https://www.youtube.com/watch?v=qbACGG6v9YQ

Figure Out a way to Make Frappe Multi Site and Multi Tenant

using Current Frappe in ERPnext, being able to offer ability to Implement other Frappe Solutions

Figure this backup to S3 option

github.com

frappe/frappe_docker/blob/main/docs/site-operations.md#push-backup-to-s3-storage

# Site operations

> 💡 You should setup `--project-name` option in `docker-compose` commands if you have non-standard project name.

## Setup new site

Note:

- Wait for the `db` service to start and `configurator` to exit before trying to create a new site. Usually this takes up to 10 seconds.

```sh
docker-compose exec backend bench new-site --no-mariadb-socket --mariadb-root-password <db-password> --admin-password <admin-password> <site-name>
```

If you need to install some app, specify `--install-app`. To see all options, just run `bench new-site --help`.

To create Postgres site (assuming you already use [Postgres compose override](images-and-compose-files.md#overrides)) you need have to do set `root_login` and `root_password` in common config before that:

```sh
docker-compose exec backend bench set-config -g root_login <root-login>

This file has been truncated. show original

Implement an internal Backup service

github.com

frappe/frappe_docker/blob/main/docs/backup-and-push-cronjob.md

Create backup service or stack.

```yaml
# backup-job.yml
version: "3.7"
services:
  backup:
    image: frappe/erpnext:${VERSION}
    entrypoint: ["bash", "-c"]
    command:
      - |
        bench --site all backup
        ## Uncomment for restic snapshots.
        # restic snapshots || restic init
        # restic backup sites
        ## Uncomment to keep only last n=30 snapshots.
        # restic forget --group-by=paths --keep-last=30 --prune
    environment:
      # Set correct environment variables for restic
      - RESTIC_REPOSITORY=s3:https://s3.endpoint.com/restic

This file has been truncated. show original

Figure Out Implementation of NExtcloud Integration
GitHub - pibico/pibiDAV: pibiDAV is a Frappe APP to Integrate Frappe and Frappe Apps with NextCloud (possibly Owncloud also but not tested)
GitHub - pibico/pibicard: CardDAV Frappe Integration
Country Specific COnfig for Switzerland
libracore/erpnextswiss at v15 (github.com)
Country Specific Config for Kenya

Grants Management (I saw some Poeple asking about solution for NGos Here)

Legal Practise and Case Management for @Adam_P_Strombergsson and @danb35

Frappe HR Implementation

frappe/hrms: Open Source HR and Payroll Software (github.com )

Kenya Compliance KRA (Revenue Authority Integration for Tax in Kenya)

navariltd/kenya-compliance: KRA eTIMS Tax Compliance Integration via OSCU with ERPNext (github.com )

Mpesa Payments (Kenya Specific Implementaion)

navariltd/frappe-mpesa-payments: The app will accommodate the setups of all Mpesa Payments (github.com )

Mpesa B2C (Kenya Specific Implementation)

navariltd/navari-mpesa-b2c: Mpesa Business to Customer (B2C) Disbursements Integration with ERPNext (github.com )

HR- Attendance timesheets

navariltd/nl-attendance-timesheet: FrappeHR app to automate creation of employee timesheets from attendance records (github.com )

HR-Causal NL Piece Rate Pay
navariltd/nl-piece-rate-pay: FrappeHR App for periodic payments to piece rate employees (github.com )
Whatsapp

shridarpatil/frappe_whatsapp: WhatsApp cloud integration for frappe (github.com )

Manual Installing Current Version

add-module ghcr.io/geniusdynamics/erpnext:0.0.2-alpha.1 1

Manual Updating to a Future Version Version

api-cli run update-module --data '{"module_url":"ghcr.io/geniusdynamics/erpnext:future-version","instances":["erpnext1"],"force":true}'

Feel free to Share your Insights, Feedback and Suggestions for Modules, Plugins and Apps that we could Pre-Implement for NS8 Community Members.

EDIT: solution for packaging apps Frequently Asked Questions · frappe/frappe_docker Wiki · GitHub

Happy Testing

kemboielvis22 · August 8, 2024, 12:35am

Also would you like some of to be preinstalled

nio707 · August 8, 2024, 11:49am

Great

oneitonitram · August 11, 2024, 5:18am

HEllo Nethians,

I am Happy to Announce that we have an initial version of custom Modules Deployment with ERPNEXT for NS8.

To help us test, Install Using:

add-module ghcr.io/geniusdynamics/erpnext:0.1.0-alpha.3-dev 1

After Installation, on the settings page menu, you should see a SelectBox

As Seen Above.

Chose the Modules you would like to pre-install and save the settings.

On ERPNExt Dashboard, you can see HR has been impelmented.

PS: I am not sure if upgrading previous alpha version to this version is possible, but you could test that scenario and report.

Happy testing

oneitonitram · August 12, 2024, 1:10pm

I am Happy to Announce a New Update is now avalable.

You can update from the previous versions via

api-cli run update-module --data '{"module_url":"ghcr.io/geniusdynamics/erpnext:0.1.0-alpha.2","instances":["erpnext1"],"force":true}'

This New Version implements a beter built custom Image Builds, with Multiple Frappe Based Apps.
We have also Ironed Out afew issues here and there, and the installation as well as Update process should be Smoother.
We Have Imporved the naming of the Apps on the SelectBox

And Have Also Added additional Apps as well.

Non ERPnext Installations
For those Seeking a Non ERPnext Frappe Installation, We have defined a custom build here

add-module ghcr.io/geniusdynamics/erpnext:frappe1.0.0-alpha.1 1

Note: ERPnext is not installed By Default in his version, and if you need it installed, you can select it.
Other standalone apps can be installed, Inlcuidng
FrappeCRM
FrappeHelpDesk
FrappeInsights
FrappeHRMS

HAppy testing

oneitonitram · September 1, 2024, 11:24am

Hello Everyone, and Happy Sunday to you All.

I am Happy to Announce the ERPnext App for Nethserver 8 HAs now Reached beta Stage, with a new release Release 1.0.0-beta.2 · geniusdynamics/ns8-erp-next (github.com)

With the Beta Release, we are confident All future Updates and Upgrades will not Break your system.

You can Install this new Version Directly from Our Repo or the Command Line through

add-module ghcr.io/geniusdynamics/erpnext:1.0.0-beta.2 1

IF you would Like to Update Directly, you can Use

api-cli run update-module --data '{"module_url":"ghcr.io/geniusdynamics/erpnext:1.0.0-beta.2","instances":["erpnext1"],"force":true}'

Depending on the Version your are upgrading from prior to Beta, Update might cause challenges, kindly just re-install.

I am Aware of COuntry Specific Customizations for the Following COuntries
France
Tanzania
Switzerland and this
GErmany

IF Any of the community Members needs the Country Specific Implementations, Kindly let us know so we can factor the same for your respective countries

HAppy Testing

We Have 2 things to Implement, then we can Have a Release Candidate.

1) Manual and Automated Internal Backups
While we know NS8 has backup Builtin, We want offer an alternative backup option for Erpnext, for both Database as well as Files, than can be retrived and restored at will.

We have tested the backup procedure manually, and it works, we would like tot automate it, and test the importation

2) Implement Ability to Install Standalone Apps, without the Need for the Full Fledged ERPnext.

i.e
HRM can be installed without erpnext
CRM can be installed Seprately
LMS can also be isntalled without ERPnext
WIKI can also be installed independently
Insights, which is a BI-Analytics tool can also be installed without Eprnext and many others

kemboielvis22 · September 3, 2024, 12:41pm

If You need other apps to be included by default you can submit a PR or an Issue