CognitixERP — Installation Guide

Video — Local installation walkthrough

Prefer watching instead of reading? This video shows CodeCanyon buyers how to install and run CognitixERP locally after purchase.

CognitixERP local installation walkthrough video thumbnail

Watch on YouTube

Direct link: https://www.youtube.com/watch?v=2zdU85KN5do

Next: Extract the package →

Step 1 — Extract the downloaded file

1 Unzip CognitixERP-v1.0.0.zip

After downloading from CodeCanyon, extract the archive. Prefer a short folder path (example: D:\CognitixERP\) to avoid Windows path-length issues.

Inside the extracted folder you will find:

Source/CognitixERP/ — Visual Studio solution
Documentation/ — offline HTML guides (this file lives here)
Database/ — notes and recovery script
README.txt, EULA.txt, CHANGELOG.md, and related package files

Next: Locate the solution →

Step 2 — Locate the project solution

2 Open CognitixERP.sln

Navigate to Source → CognitixERP, then double-click CognitixERP.sln. This launches the project in Visual Studio.

CognitixERP is built with .NET 10. Use Visual Studio 2026 (or another IDE with full .NET 10 / ASP.NET support) for the best compatibility.

← Previous Next: Verify project load →

Step 3 — Verify project load

3 Confirm folders, then Clean & Rebuild

Ensure these directories are visible in Solution Explorer:

apps — WebApp (Blazor)
src — API and all modules
test — unit tests and related projects

If they appear, the solution opened successfully.

Run Build → Clean Solution
Run Build → Rebuild Solution

Confirm NuGet packages restored correctly and the Error List shows 0 errors and 0 warnings before continuing.

← Previous Next: Push to GitHub →

Step 4 — Push to GitHub (recommended)

4 Private repo for CI/CD

It is recommended to push the project to GitHub initially. Future deployments can be automated with GitHub CI/CD.

The solution includes a deploy/ folder with scripts and templates for domain / pipeline setup.
Keep the repository private.
Push the repo to GitHub when ready.

See also: Production Deployment Guide and Source/CognitixERP/deploy/hetzner/README.md.

← Previous Next: Startup projects →

Step 5 — Configure startup projects

5 Multiple startup (HTTPS)

In Visual Studio:

Right-click the solution → Configure Startup Projects…
Choose Multiple startup projects
Set Cognitix.WebApp and Cognitix.API to Start
Use the https profile for both

← Previous Next: Database →

Step 6 — Database configuration

6 Choose an engine

CognitixERP supports PostgreSQL, SQL Server, and MySQL. For this guide we use PostgreSQL as an example — create a database instance (or ensure your login can create one).

You do not need to edit connection strings by hand. The Setup Wizard writes them for you. The DB password is your database engine login password.

← Previous Next: Run & Setup Wizard →

Step 7 — Run the project & Setup Wizard

7 F5 and complete /setup

Start debugging. The browser opens the Setup Wizard at /setup. Fill the required fields — no dotnet ef commands needed.

Local URLs (default)

Field	Value
Frontend URL	`https://localhost:7019`
API URL	`https://localhost:7149`

Do not append /api to the API URL. The WebApp already calls paths like api/....

Wizard flow

Database & URLs — company, engine, host, database name, credentials → Continue
Administrator — create your first admin account
License — locally, click Skip — 14 day trial

Setup Wizard Step 1 — Database and infrastructure — **Step 1 — Database & infrastructure** — company names, Frontend/API URLs, SQL Server/PostgreSQL/MySQL, and database name. Provisioning is automatic (keep the tab open).

Example — Local SQL Express values

Frontend URL: https://localhost:7019 · API URL: https://localhost:7149 (no /api suffix).
Engine: SQL Server · Server: .\SQLEXPRESS · choose a database name → Continue.

Result: Schemas for all modules are created (often 3–8 minutes).

Setup Wizard Step 2 — Administrator account — **Step 2 — Administrator account** — username, email, and a strong password. There is no default admin password in the package.

Example — Strong admin password

Fill Admin Username, Email, Password, Confirm Password (8+ chars with upper, lower, number, special).
Click Continue.

Result: First admin account is ready for login after setup.

Setup Wizard Step 3 — License activation — **Step 3 — License activation** — Activate with Envato purchase code, or *Skip — 14 day trial* for local development.

Example — Local trial

On a local Visual Studio run, click Skip — 14 day trial.
On production, enter Envato username, email, and purchase code → Activate Now.

Result: Trial or Active license is recorded and the completion screen appears.

Setup Wizard complete — You're ready to go — **Setup complete** — verify API health, copy WebApp `ApiBaseUrl` if needed, then Go to Login.

Example — Sign in after F5

Restart the API if it recycled, then open https://localhost:7149/api/system/health.
Click Go to Login or browse to https://localhost:7019/users/login.

Result: You sign in with the admin from Step 2 and can follow the User Manual first steps.

Please wait. Preparing the database can take from a few seconds to several minutes. Do not stop Visual Studio, close the tab, or cancel the request while it runs.

On a live / production site you can enter your Envato purchase code in Step 3. For local development, skip activation and use the trial for now.

When setup finishes successfully, restart the API (stop and Start again), then sign in at:

https://localhost:7019/users/login

After the first successful setup, database migrations and later updates apply automatically when the API runs — usually only a few seconds on restart.

Project configured. Log in with the admin account you created in the wizard.

← Previous Next: Docs & support →

Step 8 — Documentation & support

8 Keep learning & get help

Please Contact us

Sign up at https://cognitivebd.com
Create a Support Ticket.
Within 48hr we will reply.

Or email support@cognitivebd.com with your purchase code, version, and screenshots/logs.

← Previous

CognitixERP Installation Guide