Self-Hosted Installation

This is the installation manual for the self-hosted edition of the app for your own server.

Overview

SalesRep App is a web-based application designed to empower support teams in delivering outstanding customer service. It is a .NET 10 web-application accessed via web browser.

System Requirements

Hardware

• RAM: 16GB recommended for single-server deployments; 8GB otherwise acceptable.
• CPU: Multi-core CPU with 4 cores recommended.
• Storage: Depends on ticket volume. Approximately 100MB for 5,000 tickets plus attachment storage.

Platforms

• Microsoft Windows Server 2016 or later
• Linux (tested on Ubuntu, CentOS, WSL2, Debian)
• Docker

Prerequisites

Windows: .NET 10 Hosting Bundle, IIS web-server with ASP.NET, Microsoft SQL Server 2012 or later (Express and Developer editions are free). Linux: Modern Linux distribution, SQL Server, .NET Runtime 10 or later. Docker: Docker engine in any form.

Windows Installation

Can be installed automatically by launching setup.exe or manually. For manual install: copy files to IIS virtual directory, configure as application in IIS, execute CreateEmptyDB.sql then CreateTables.sql, edit appsettings.json connection string.

Linux Installation

1. Install SQL Server
2. Create database using CreateEmptyDB.sql and CreateTables.sql
3. Install .NET Runtime 10
4. Update appsettings.json connection string
5. Run: dotnet App.dll

Optional: Configure Nginx reverse proxy and register as systemd service for auto-start.

Docker Installation

1. Download and unzip the package
2. Navigate to the app folder
3. Run docker compose up --build
4. Open at http://localhost

First Login

Default users: admin (password "admin") and client (password "client"). Change these default passwords before production use.

Upgrading

The app includes an auto-update module. Launch Setup.exe to download the latest version. For manual upgrade: backup current folder, replace files (keep appsettings.json), run upgrade SQL script.

Advanced Features

• appsettings.json — Advanced configuration including file storage path, error logging, mail settings, proxy IP, allowed file extensions.
• Full-Text Search — Install SQL Server Full-Text Search components for better search performance.
• Windows Authentication — Active Directory integration supported.
• Storing files on disk — Configure AttachmentsPath in appsettings.json.