Launch and Database Connection
Start Muhasib ERP, connect or create its database, and resolve common startup interruptions.
- Launch Muhasib ERP
- Resolve a Muhasib Startup Interruption
- Connect Muhasib ERP to an Existing Database
- Create a New Muhasib Database
Launch Muhasib ERP
How to Launch Muhasib ERP in Muhasib ERP
Overview
This guide will help you start Muhasib ERP and recognize whether it is proceeding normally or needs database, activation, onboarding, or recovery action.
Startup can create missing default settings and may initialize or migrate database data. A successful set up launch reaches sign-in and then the authorized company workspace.
Who can do this
You need access to Permission to run the installed application. Database or activation administration may be required if first-run setup appears.
Before you start
Prepare the computer and make sure the set up SQL Server is reachable. Back up the database before the first launch of a newer application build.
Where to find it
Follow the launch, wizard, login, company-selection, Back Office, or power path described in the procedure; the available starting screen depends on current installation state.
Launch Muhasib ERP
Step 1: Start Muhasib ERP from the approved Windows shortcut or executable
Step 2: Wait while the launcher displays Initializing Muhasib ERP...
Step 3: Allow the launcher to check the database, initialize required data,
Allow the launcher to check the database, initialize required data, evaluate the licence, and load available modules.
Step 4: Continue according to the screen that opens
Continue according to the screen that opens:
- Database Setup: connect or create the approved database.
- Activation: choose the correct licence path.
- Company/Administrator wizard: complete first-time onboarding.
- Sign in: enter your Muhasib credentials.
Step 5: If an error remains on screen, record its title and
If an error remains on screen, record its title and message before closing it.
Check your work
The launcher closes and an expected next screen appears. You should not see a repeating database, activation, initialization, or capacity error.
If something goes wrong
- Do not repeatedly restart during an apparent migration.
- Do not point the application at a different database merely to bypass an error.
- If the database revision or application build is uncertain, preserve the error and contact support.
Related guides
- Prepare a Computer to Run Muhasib ERP
- Resolve a Muhasib Startup Interruption
- Connect Muhasib ERP to an Existing Database
- Choose the Correct Muhasib Activation Path
- Sign In to Muhasib ERP
What to do next
Resolve a Muhasib Startup Interruption
How to Resolve a Muhasib Startup Interruption in Muhasib ERP
Overview
This guide will help you classify a startup interruption and take a safe recovery action without risking the business database or licence assignment.
If this issue is stopping your work, do not worry. Follow the steps one at a time, and check the result before trying again.
Muhasib advances to the next allowed lifecycle state or preserves the current state for safe diagnosis; the verification section identifies the expected result.
Who can do this
You need access to Use requires the rights and business authority described by the workflow. Database, licence, user, company, or system changes require the responsible administrator.
Before you start
Record the application version/build if known, database server and database name without credentials, the exact message, and whether this is a new installation, ordinary launch, or upgrade.
Where to find it
Follow the launch, wizard, login, company-selection, Back Office, or power path described in the procedure; the available starting screen depends on current installation state.
Resolve a Muhasib Startup Interruption
Step 1: Identify the stage that failed
Identify the stage that failed:
- before database selection: workstation settings or installation;
- while connecting: server, network, authentication, or database selection;
- while initializing: missing base records, database revision, or migration;
- during activation: network, account, subscription, pairing, or terminal state;
- after activation: plan feature or capacity limit;
- before workspace: company, user, role, or terminal registration.
Step 2: Copy the exact error text or take a sanitized screenshot
Step 3: Check only the dependency named by the error. For example,
Check only the dependency named by the error. For example, check network reachability before changing database settings.
Step 4: Retry once after correcting a known temporary condition
Step 5: If the error concerns migration, partial database creation, licence transfer,
If the error concerns migration, partial database creation, licence transfer, or an unknown data change, stop and contact support.
Step 6: Provide the installed version, database revision when available, terminal type,
Provide the installed version, database revision when available, terminal type, and recent change that preceded the failure.
Check your work
The corrected launch advances past the failed stage and reaches the expected next screen. Make sure the selected company and database are the intended ones.
If something goes wrong
If the expected result is not shown, stop repeated attempts, check the active database/workspace/user/licence context, preserve the exact message, and follow the related recovery article.
Related guides
- Launch Muhasib ERP
- Connect Muhasib ERP to an Existing Database
- Review and Maintain Muhasib Licence Access
- Check the Installed Muhasib Version and Database Revision
- Request Muhasib Support
What to do next
Connect Muhasib ERP to an Existing Database
How to Connect Muhasib ERP to an Existing Database in Muhasib ERP
Overview
This guide will help you configure this workstation to use an existing approved Muhasib database.
Muhasib stores the selected host, database, authentication mode, and needed credentials in the local workstation settings. On startup it may create missing default settings or apply supported initialization/migration work.
Who can do this
You need access to Access to Database Setup and valid SQL Server. Get the connection details from the database administrator.
Before you start
Confirm the SQL Server name, database name, authentication method, and whether the database revision is compatible with this Muhasib build. Keep a verified backup before connecting a newer build.
Where to find it
Follow the launch, wizard, login, company-selection, Back Office, or power path described in the procedure; the available starting screen depends on current installation state.
Connect Muhasib ERP to an Existing Database
Step 1: Open Database Setup during first launch or through the approved
Open Database Setup during first launch or through the approved setup route.
Step 2: In Server, select or enter the approved SQL Server
Step 3: Choose the authentication method
Choose the authentication method:
- Windows authentication uses the current Windows identity.
- SQL authentication requires the assigned database username and password.
Step 4: Connect to the server so Muhasib can load the database list
Step 5: Select the exact existing Muhasib database. Do not select an
Select the exact existing Muhasib database. Do not select an empty or unrelated business database.
Step 6: Choose Apply DB Settings
Step 7: Continue through initialization, activation, onboarding, or sign-in as prompted
Check your work
Restart Muhasib and confirm that it reconnects to the same database and shows the expected company or sign-in context.
If something goes wrong
- An empty database list usually indicates connectivity, authentication, or SQL permissions problems.
- If the chosen database is not recognized as Muhasib, stop rather than allowing uncertain initialization.
- Never expose the stored SQL password in a screenshot or support attachment.
Related guides
- Prepare a Computer to Run Muhasib ERP
- Create a New Muhasib Database
- Resolve a Muhasib Startup Interruption
- Choose the Correct Muhasib Activation Path
What to do next
Create a New Muhasib Database
How to Create a New Muhasib Database in Muhasib ERP
Overview
This guide will help you create a new empty Muhasib database for a new workspace on an approved SQL Server.
The available build creates the fixed database name MUHASIB, applies its base script in batches, and saves the new connection in local workstation settings. Creation changes SQL Server state and may leave a partial database if interrupted; verified rollback behavior is still required.
Who can do this
You need access to Database-creation rights on a non-production or approved SQL Server. This procedure must not be used to repair or replace an existing company database.
Before you start
Make sure a database named MUHASIB does not already contain required data. Understand the organization's backup, server naming, collation, security, and recovery policies.
Where to find it
Follow the launch, wizard, login, company-selection, Back Office, or power path described in the procedure; the available starting screen depends on current installation state.
Create a New Muhasib Database
Step 1: Open Database Setup
Step 2: Select the approved SQL Server and authentication method
Step 3: Enter SQL credentials only when SQL authentication is required
Step 4: Verify that you are connected to the intended server
Step 5: Choose Create new Database
Step 6: Allow Muhasib to create MUHASIB and execute its embedded base
Allow Muhasib to create MUHASIB and execute its embedded base database script.
Step 7: Do not close the application or interrupt SQL Server while
Do not close the application or interrupt SQL Server while creation is in progress.
Step 8: After completion, continue to activation and first-company onboarding
Check your work
Make sure Muhasib reconnects successfully, recognizes the expected database revision, and opens activation or onboarding. A database existing in SQL Server is not enough proof; the application must initialize it successfully.
If something goes wrong
- If
MUHASIBalready exists, do not overwrite or remove it. Confirm its owner and purpose. - If permissions fail, have the database administrator create or authorize the database through the supported deployment process.
- If creation stops partway, preserve logs and contact support before retrying or cleaning up.
Related guides
- Connect Muhasib ERP to an Existing Database
- Choose the Correct Muhasib Activation Path
- Create the First Company Workspace
- Create and Verify a Manual Backup