Before You Begin: System Requirements
Before installing or activating your license, make sure the following conditions are met. Skipping these checks is the single most common cause of problems:
Hardware: Ensure your PC meets Microvellum's minimum hardware requirements. Check the following article for the current specification list, as these are updated with each major version.
Admin rights: You are logged into Windows with an Administrator account or can launch programs as Administrator. Without this, installation and activation will silently fail or behave unpredictably.
Internet connection: You have a reliable internet connection for online license activation. An offline option is available if needed — see the 'Activating Your License' section below.
VPN / Proxy: Any VPN or proxy is temporarily disabled during initial activation. These can intercept the license check and cause it to fail.
TIP: If you are setting up Microvellum on a managed device, alert your IT team before you start. They will need to whitelist several programs and ports — the full list is in the Firewall and Network Configuration and Quick Reference sections.
Activating Your License
Microvellum BSB requires a valid license to run. This section covers how to activate it and what to do if activation fails.
Why Activation Sometimes Fails
Wrong key: The license key was entered incorrectly — check for common typos such as the number 0 vs. the letter O, or 1 vs. l.
Version mismatch: You are using a key for the wrong version of Microvellum — ensure the key matches the installed version.
Expired license: Your annual maintenance or subscription period has lapsed. Contact Microvellum or your reseller to renew.
Firewall block: Your firewall or antivirus is blocking Microvellum from reaching the software servers. See the 'Firewall and Network Configuration' section below for what to whitelist.
Hardware change: Major hardware changes — such as replacing a hard drive or network adapter — can cause the software to think it's running on a different machine, invalidating the license. Contact Microvellum support if this happens.
Standard Online Activation
Check your current license status
Open Microvellum→ Help → About Microvellum. The license status displayed here will tell you whether it is active, expired, or unrecognized.Re-enter your license key
Go to Activation Settings and carefully type your license key. Even a single wrong character will cause the activation to fail.Disable VPN or proxy temporarily
If you use a VPN, turn it off before attempting activation. Re-enable it once activation is complete.Allow Microvellum through your firewall/antivirus
If activation still fails, your security software may be blocking it. Add Microvellum.exe and BricsCAD_bsb.exe to the allowed list. See the 'Firewall and Network Configuration' section for the complete list of executables.
Offline Activation (No Internet Available)
If the machine running Microvellum cannot reach the internet, you can activate it manually using another device.
Choose the offline / manual activation option
This is found on the activation screen within Microvellum.Generate a request file
Microvellum will create an activation request file and save it to your machine.Upload the request file
On any internet-connected device, visit the Microvellum licensing portal (see this article for more information) and upload the request file.Download the response file
The portal will generate a response file. Download it and transfer it back to the Microvellum machine (via USB, email, etc.).Import the response file
Back in Microvellum, use the same offline activation screen to import the response file. Activation will then complete.
Running Microvellum as Administrator
A very large number of Microvellum problems — including activation failures, missing features, and crashes — are caused simply by the program not having the Windows permissions it needs. Always run Microvellum as Administrator.
Option A — Run as Administrator Just Once (Quick Fix)
Right-click the Microvellum shortcut on your desktop or Start menu.
Select "Run as administrator" from the menu that appears.
Confirm any Windows security prompt that appears.
NOTE: This only applies for the current session. You will need to repeat it each time you open Microvellum . Use Option B to make it permanent.
Option B — Always Run as Administrator (Recommended)
Find the Microvellum shortcut
Locate it on your desktop or in the Start menu.Open its properties
Right-click the shortcut and select "Properties".Go to the Compatibility tab
Click the "Compatibility" tab at the top of the Properties window.Enable administrator mode
Tick the checkbox labelled "Run this program as an administrator".Save
Click "Apply", then "OK". Microvellum will now always open with Administrator privileges.
Option C — Apply to All Users on This Machine
If multiple Windows accounts use Microvellum on the same PC, do the following in addition to Option B:
In the same Compatibility tab, click "Change settings for all users".
Tick "Run this program as an administrator" in the window that appears.
Click "Apply" and confirm.
Fixing "Unable to Validate License" / Error Code -1
This error appears on the BricsCAD activation screen and usually reads: "Unable to validate license" or "Unable to activate license", sometimes accompanied by Error Code: -1.
It is most commonly caused by leftover files from a previous installation or activation attempt conflicting with the new one. Work through the steps below in order.
Step 1 — Confirm the Software Was Installed as Administrator
If Microvellum was installed without Administrator rights, the program will not have the directory permissions it needs, causing this error.
Uninstall Microvellum completely.
Right-click the installer file and select "Run as administrator".
Re-install, then attempt activation again.
Step 2 — Delete Old Activation Files
These files are safe to delete. Microvellum will automatically create fresh ones when you reactivate.
Location 1: Navigate to
C:\ProgramData\Microvellum
Find the file with the most recent modified date — it will typically be a 6-digit number (e.g. 483921). Delete it.Location 2: Navigate to
C:\ProgramData\Bricsys
Delete the file namedLicenseManager.cfg
Delete the file namedtoolboxV25.lic
TIP: ProgramData is a hidden Windows folder. To see it, open File Explorer → click the "View" menu (or tab) → tick "Hidden items". It will then appear in your C:\ drive.
Step 3 — Clean Up the Registry
The Windows Registry stores low-level program settings. Only proceed with this step if the above steps did not resolve the issue.
WARNING: Only delete entries within the Microvellum\KeyInfo path described below. Do not change anything else in the registry — incorrect changes can affect Windows itself.
Open the Registry Editor
Press Windows + R, typeregedit, and press Enter. Click Yes on any security prompt.Navigate to the Microvellum key
In the left-hand panel, expand the folders to reach:
Computer \ HKEY_CURRENT_USER \ Software \ Microvellum \ KeyInfoDelete the activation entries
Select and delete the license/activation key entries listed in the right-hand panel of that folder.Close the Registry Editor
Step 4 — Relaunch and Reactivate
Open Microvellum. The activation screen should now appear automatically. Enter your license key to complete activation. If the problem persists after all of the above steps, proceed to the 'Firewall and Network Configuration' section below to check for network-related causes.
Firewall & Network Configuration
If your organization uses a managed firewall or a high-security network, certain Microvellum features — including license activation and library updates — may be blocked. Your IT team will need to add exceptions for the items listed below.
Executable Files to Allow
Executable File | What It Does |
| Main application launcher — must always be allowed |
| The CAD engine that powers Microvellum BSB |
| CAD engine for Microvellum AC/Legacy OEM software |
| Downloads and installs library updates |
| Opens and manages the Microvellum database |
| Imports and exports libraries and project files |
| Generates CAM / machining output files |
| Edits specification groups and product rules |
| Views .sdf configuration files (optional utility) |
Network Ports to Open
Port | Protocol | Purpose |
80 | TCP | HTTP — used for library updates and online resources |
443 | TCP | HTTPS — used for secure license checks and updates |
1433 | TCP | SQL Server — required when using a networked SQL database (Microvellum Server/Processing Center) |
1434 | UDP | SQL Server Browser — helps locate the SQL Server instance on the network |
3306 | TCP | MySQL — only needed for custom database setups |
445 | TCP | SMB — Windows file sharing, used for networked configuration files |
137–139 | UDP | NetBIOS — network discovery and file access |
NOTE: If you are running a local-only setup using .sdf (SQL CE) database files, you do NOT need to open the SQL ports (1433, 1434, 3306). These are only required when connecting to a central SQL Server on the network.
Networked Database Setup
For teams sharing a central database, host the SQL database on a dedicated server and connect all workstations to it via your LAN. Ensure the SQL Server is reachable from each workstation and that the SQL ports above are open.
Remote Desktop (RDS) — Known Issues & Alternatives
Remote Desktop Services (RDS) allows multiple users to connect to a single server and run applications remotely. While this is convenient for many programs, Microvellum BSB is not designed for RDS and running it this way causes a range of problems.
WARNING: Microvellum does not recommend running Microvellum BSB on Remote Desktop Services. The issues below are inherent to how RDS works and cannot easily be worked around.
Known Problems with RDS
Licensing conflicts: BricsCAD's license system is not designed for multi-user server sessions. Multiple users sharing the same server can trigger license conflicts, causing some users to be locked out entirely.
Graphics / GPU issues: BricsCAD requires a real GPU for rendering. RDS sessions typically use a virtual or software display, resulting in lag, graphical glitches, and crashes.
File path conflicts: Microvellum stores settings using paths tied to each user and their local file locations. When multiple RDS users share a server, these paths collide, causing errors, missing settings, or corrupted configurations.
Update instability: Running a library update on an RDS server can corrupt the shared installation for all users simultaneously, or cause version mismatches between sessions.
Project isolation failures: Microvellum uses internal sandboxing to keep projects separate. This mechanism does not behave reliably in an RDS environment and can result in data being mixed up between users — a serious risk for production work.
Recommended Alternatives
Dedicated local workstations (best option): Each user should run Microvellum BSB on their own dedicated workstation with a local installation and local Administrator rights. This is the configuration Microvellum designs and tests for.
VDI with GPU passthrough: If remote or virtualized access is required, use a VDI platform that provides each user with a dedicated virtual GPU — for example, NVIDIA GRID / vGPU. This resolves the graphics issues and provides proper user isolation. This is significantly more complex and costly to set up than local workstations.
Shared database on a central server: For sharing project and product data across the team, host the SQL database on a central server and connect workstations to it over the LAN. This gives you shared data without the risks of running the application itself in RDS.
Quick Reference: Ports & Executables
Use this section as a quick handout for your IT team when configuring firewall rules.
Executables Summary
File | Purpose |
| Main launcher |
| CAD engine (BSB) |
| CAD engine (OEM/AutoCAD) |
| Library updater |
| Database explorer |
| Import / export |
| CAM / machining output |
| Specification editor |
| Config file viewer (optional) |
Ports Summary
Port | Type | Required For |
80 | TCP | HTTP — updates & resources |
443 | TCP | HTTPS — licensing & secure updates |
1433 | TCP | SQL Server (networked DB only) |
1434 | UDP | SQL Server Browser (networked DB only) |
3306 | TCP | MySQL (custom setups only) |
445 | TCP | SMB file sharing (networked config) |
137–139 | UDP | NetBIOS network discovery |

