---
title: BxLogistics installation part 1 - BxEngine
description: This is the beginning of the installation process for BxLogistics/BxSales/BxLabels. Part 1 consists of installing BxEngine.
---

[Skip to content](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-1-bxengine#main-content)

- [English](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-1-bxengine)
- [Norsk – Norge](https://kb.bxsoftware.no/hjelp/bxlogistics-installasjon-del-1-bxengine)

English

Show submenu for translations

[![BxSoftware\_Logo\_Wordmark\_Color](https://kb.bxsoftware.no/hubfs/BxSoftware_Logo_Wordmark_Color.svg)](https://www.bxlogistics.no/)

- [Henvendelser](https://kb.bxsoftware.no/tickets)
- [Selvhjelp](https://kb.bxsoftware.no/hjelp)
- [Logg ut](https://kb.bxsoftware.no/_hcms/mem/logout)

Open main navigation

Close main navigation

- [Henvendelser](https://kb.bxsoftware.no/tickets)
- [Selvhjelp](https://kb.bxsoftware.no/hjelp)
- [Logg ut](https://kb.bxsoftware.no/_hcms/mem/logout)
- - [English](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-1-bxengine)
    - [Norsk – Norge](https://kb.bxsoftware.no/hjelp/bxlogistics-installasjon-del-1-bxengine)

  English
  
  Show submenu for translations

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Selvhjelp](https://kb.bxsoftware.no/en/hjelp?hsLang=en)
2. [BxLogistics Installation](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en)
3. [BxLogistics](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#bxlogistics)

# BxLogistics installation part 1 - BxEngine

## This is the beginning of the installation process for BxLogistics/BxSales/BxLabels. Part 1 consists of installing BxEngine.

Are you using a cloud based ERP system such as VismaNet, Business Nxt, Business Central, Tripletex, etc.? You can skip this article and go directly to Part 2. The installation of BxEngine is only relevant for On-Prem systems such as Visma Business, Visma Global, SAP Business One, Multicase, Uni Økonomi V3, etc.

### Installation of BxLogistics, BxSales and BxLabels can be divided into several areas:

- **Installation of BxEngine and BxSmartPrintPro services** on the server, which are the main components of the Bx solution.
- **Setting up integration with ERP** in BxAdmin and connecting to terminals with BxMobile and/or conecting printers in BxSmartPrintPro.

#### Installation steps:

- **Part 1 - BxEngine** - Installation of BxEngine (this article).
- [**Part 2 - BxAdmin**](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-2-bxadmin?hsLang=en) - Setup in BxAdmin
- **[Part 3 - BxMobile](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-3-bxmobile?hsLang=en)** - Installation of handheld terminals (can be done independently of Parts 1 and 2).
- **[Part 4 - Pairing BxMobile](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-4-bxmobile?hsLang=en)** - Pairing handheld terminals/BxMobile (dependent on Parts 1-3).
- **[Part 5 - BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/installasjon-bxsmartprintpro?hsLang=en)** - Can be installed independently of Parts 1-4.

If you are looking for instructions on **migrating an existing BxLogistics/BxEngine installation**, you can find them [here.](https://kb.bxsoftware.no/en/hjelp/flytting-bxlogistics-bxengine-og-bxsmartprintpro?hsLang=en)

If you need to install an additional BxEngine service on the same server, instructions can be found [here.](https://kb.bxsoftware.no/en/hjelp/installere-flere-bxengine-p%C3%A5-samme-server?hsLang=en)

### BxEngine Installation Requirements

BxEngine must be installed on a **Windows server or PC**. The database requires **Microsoft SQL Server (SQL Express/Standard, etc.)**, and the BxEngine service requires **.NET Framework 4.8**.

### What you need for Part 1:

BxEngine Installation file

- Download from our **partner portal**: [https://partner.bxsoftware.no/](https://partner.bxsoftware.no/)
- Requires login. If you do not have an account, contact [support@bxsoftware.no](mailto:support@bxsoftware.no) to create a user account (if you are a registered reseller of our solutions).

                            

#### Steps:

1. Open **Home** and find **Downloads** in the top-right corner.
2. Download "**BxEngine for BxLogistics/BxSales/BxStockCount**" from the **Releases** section.
   
   ![image-132](https://kb.bxsoftware.no/hubfs/image-132.png)![](https://kb.bxsoftware.no/hubfs/image-png-Oct-28-2022-10-55-11-7110-AM.png) ![](https://kb.bxsoftware.no/hubfs/image-png-Oct-28-2022-10-57-20-5764-AM.png)

#### License Key for BxEngine

- Find the license key under **Licenses** in the portral.
- Search for the customer, then click the **license key button** to copy the key.
  
  ![](https://kb.bxsoftware.no/hubfs/image-png-Oct-28-2022-11-06-50-2359-AM.png)

#### Admin Access on the Application Server

BxEngine is usually installed on the same server as the **ERP solution's application server**, but it can also be installed elsewhere, depending on the ERP system.

**Examples:**

- **Visma Global**: Requires access to **SDK/API**; therefore, it is almost always installed on the Visma Global app server.
- **Visma Business**: Needs access to the **EDI area**, either on the same machine or via **UNC/network path**. If using **VBS instead of EDI**, access to the **VBS installation directory** is required.
- **SAP Business One (SAP B1)**: If BxEngine is installed on a different server than the SAP server, **SQL Server Native Tools 20xx** and **SAP DI API SDK** must be installed.
- **Uni Økonomi V3**: Must be installed on the same server as the **Uni Import Service**, usually the **Uni Økonomi server**.

If using a **UNC path** to **EDI or VBS directories**, a **service user** must be configured with the necessary access rights for BxEngine.

#### Admin Access on SQL Server

- Full admin access is not strictly required, but you need permission to **create a SQL database** and **a SQL user**.

      

### Firewall/Port Openings

- Typically, **port 443 (outbound)** is required - More information is available **[here](https://kb.bxsoftware.no/en/hjelp/firewall-/-infrastructure-/-network-communication?hsLang=en)**.

#### Creating SQL Database and User

BxEngine requires its own **database** to store configuration data, logs, and operational data such as inventory counts.

Since BxEngine often retrieves data from the **ERP database**, it will need **read access** to that database.

#### BxEngine Database Setup

1. **Create a new SQL database** (e.g., `BxEngine`).
   
   #### ![bxloginstdel1bxeng2](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng2.png?width=655&name=bxloginstdel1bxeng2.png)
   
   #### ![bxloginstdel1bxeng3](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng3.png?width=257&name=bxloginstdel1bxeng3.png)
2. **Create a new SQL login for BxEngine:**
   
     - Use **SQL Server authentication**.
     - Disable **"Enforce password policy"** (to prevent password expiration issues).
     - Set **default database** to the newly created BxEngine database.
       
       #### ![bxloginstdel1bxeng4](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng4.png?width=655&name=bxloginstdel1bxeng4.png)

#### **Assign Permissions:**

- **BxEngine database:**
  
    - `db_owner` (to allow database structure changes during upgrades).![bxloginstdel1bxeng5](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng5.png?width=622&name=bxloginstdel1bxeng5.png)
- **ERP database:**
  
    - `db_datareader` (for reading ERP data).
    - `db_datawriter` (if integrating with **Uni Micro ERP**).![bxloginstdel1bxeng6](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng6.png?width=622&name=bxloginstdel1bxeng6.png)

If installing on an **ASP provider’s shared database instance**, follow their naming convention (e.g., `CustomerName_BxEngine_Prod`).

Note: The **BxEngine database** does not have to be on the same SQL server as the ERP database.

Installation

1. Run the **BxEngine.msi** file you downloaded earlier.
2. Follow the setup wizard:
   
     - Click **Next** → Choose an **installation folder** → Click **Next** → Click **Finish**.
3. After installation, start **BxEngine Monitor** from the desktop shortcut. (It may take some time to start on some servers/PCs.)
4. When BxEngine Monitor opens, a **Setup Box** will appear asking for:
   
     - **License Key:** Retrieve from **partner portal → Licenses**.
     - **SQL Server:** Enter `ServerName\Instance,Port` (if not using default port **1433**).
     - **Database:** Select the **BxEngine** database (not the ERP database).
     - **User:** Enter the SQL user you created (`bxengine`).
     - **Password:** Enter the SQL user’s password.

![bxloginstdel1bxeng7](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng7.png?width=406&name=bxloginstdel1bxeng7.png)

⚠ **Important:**

- The **bxengine user must have db\_owner rights** on the BxEngine database during installation and operation.
- **Do not enter the ERP database here**—use only the BxEngine database.
- **Use a strong password** for the SQL user.
- **Windows Authentication is not supported**—a SQL user is required.

### Database Initialization

- After entering the database details, click **Confirm**.
- If you encounter issues, verify:
  
    - **Username/password**
    - **SQL server connection settings**

![](https://kb.bxsoftware.no/hubfs/image-png-4.png)

### Starting and Changing the Service User

- Once the database is set up, BxEngine Monitor will show a **status screen** and start the **Windows service**.
- If BxEngine needs **network drive access**, restart the service and assign a **service user** with the required permissions.

![bxloginstdel1bxeng10](https://kb.bxsoftware.no/hs-fs/hubfs/bxloginstdel1bxeng10.png?width=496&name=bxloginstdel1bxeng10.png)

### Next Step: Setting up BxAdmin

**[BxLogistics Installation Part 2 - BxAdmin](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installasjon-del-2-bxadmin?hsLang=en)**

**⚠ Troubleshooting:**

If you get a **404 error** when logging into Bxdmin:

1. Stop the **BxEngine service**.
2. Restart it and wait about **30 seconds**.
3. Try logging in again.

 

- [BxLogistics Installation](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#main-content)

    - [BxEngine and BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#bxengine-and-bxsmartprintpro)
    - [BxLogistics](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#bxlogistics)
- [ERP Integrations and setup](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#main-content)

    - [Visma Business](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#visma-business)
    - [VBNxt](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#vbnxt)
    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#visma-net)
    - [Xledger](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#xledger)
- [Transport integrations](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#main-content)

    - [AxiaFrakt](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#axiafrakt)
    - [Logistra Cargonizer](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#logistra-cargonizer)
    - [ERP delivery methods](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#erp-delivery-methods)
    - [nShift Shipment Server](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-shipment-server)
    - [nShift/Unifaun Online](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-unifaun-online)
    - [nShift/Consignor OnPrem](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-consignor-onprem)
- [User guides BxMobile](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#main-content)

    - [General](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#general)
    - [Stock transfer](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#stock-transfer)
    - [Products](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#products)
    - [Picking](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#picking)
    - [Stock count](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#stock-count)
- [User Guides BxWebManager](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#main-content)

    - [General](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#general)
    - [Labels](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#labels)
- [Technical Documentation](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#main-content)

    - [BxAdmin - Client UI](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#bxadmin-client-ui)
    - [BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#bxsmartprintpro)
    - [Picking - Freight booking](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#picking-freight-booking)
    - [Infrastructure](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#infrastructure)
    - [Visma Global specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#visma-global-specific)
    - [Visma Business specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#visma-business-specific)
    - [VismaNet specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#vismanet-specific)
- [Stock count](https://kb.bxsoftware.no/en/hjelp/stock-count?hsLang=en#main-content)

    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/stock-count?hsLang=en#visma-net)
- [Logistics](https://kb.bxsoftware.no/en/hjelp/logistics?hsLang=en#main-content)

    - [Location](https://kb.bxsoftware.no/en/hjelp/logistics?hsLang=en#location)
- [Troubleshooting](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#main-content)

    - [Freight](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#freight)
    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#visma-net)
    - [BxMobile](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxmobile)
    - [BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxsmartprintpro)
    - [Visma Business](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#visma-business)
    - [BxAdmin](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxadmin)
- [BxAPI](https://kb.bxsoftware.no/en/hjelp/bxapi?hsLang=en)
- [Video archive](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#main-content)

    - [Sales](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#sales)
    - [Stock pick](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#stock-pick)
    - [Stock count](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#stock-count)
    - [General](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#general)
    - [BxWebManager](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#bxwebmanager)

[![BxSoftware\_Logo\_Symbol\_Color](https://kb.bxsoftware.no/hubfs/BxSoftware_Logo_Symbol_Color.svg "BxSoftware_Logo_Symbol_Color")](https://www.bxlogistics.no/)

Karihaugveien 89, Oslo, Norway

<https://www.linkedin.com/company/9465221/admin/dashboard/> <https://www.facebook.com/> [mailto:support@bxsoftware.no](mailto:support@bxsoftware.no)

Copyright © 2025, BxSoftware AS