Getting started

This section explains how to set up and start using the web application. For development environment setup, please refer to the developer's getting started guide.

IMPORTANT: In many cases a development partner of yours can create its own deployment of Tefter.bg by extending the addons it is using with customized ones.

Environment Setup

  1. Windows Server 2012R2+ is the recommended production operating system. Support for other operating systems will be added in future updates.
  2. Tefter.bg is built using .NET Core applications and libraries. Ensure the .NET Core framework is installed. Visit the .NET Download page, select "All downloads" for the latest version, and download and install the latest "Hosting bundle."

Database Installation

  1. Go to the PostgreSQL download page.
  2. Click the Download the installer link.
  3. On the "enterprisedb.com" page, click the download icon for "Windows x86-64" for the latest version.
  4. Follow the installation instructions to install the software.
  5. Important: Securely store the root database password.
  6. Install the "pgAdmin" database management tool. If not already installed, download it from the pgAdmin website.
  7. Launch "pgAdmin" and create a database (e.g., "tefterbg").

Web Application Installation

  1. Create a "Web application" folder on your server.
  2. Create a "File repository" folder on your server, ideally outside the "Web application" folder for easier updates. Note: You can use an existing empty local or network folder.
  3. Create a website in your IIS web server, pointing it to the "Web application" folder. Stop the site for now.
  4. Ensure the IIS web server worker process has read and write permissions for the "Web application" and "File repository" folders and subfolders.
  5. Download the latest Tefter.bg version archive.
  6. Extract the archive directly into the "Web application" folder. You should see "wwwroot" as a subfolder and "appsettings.json" in the root directory.

Web Application Configuration

  1. Open "appsettings.json" in a text editor.
  2. Copy and paste the appropriate "ConnectionString" value based on your database name and location (e.g., "Server=localhost; Port=5432; User Id=DB_USER_NAME; Password=DB_USER_PASSWORD; Database=DATABASE_NAME; Pooling=true; MinPoolSize=1; MaxPoolSize=100; CommandTimeout=600;").
  3. Enter a "CryptoPassword" for data encryption.
  4. Specify a "CompanyName" or leave it empty for the default "Tefter.bg."
  5. Provide a "CompanyLogoUrl" or leave it empty for the default logo.
  6. Set the "BaseUrl" to match the intended URL for the application.
  7. Enter the path to the "File repository" folder, which can be local (e.g., "c:\folder") or network (e.g., "\\192.168.0.190\TefterBlobStorage"). Remember to escape backslashes by doubling them.
  8. Configure the EMAIL > SMTP settings with the necessary information.
  9. If using "Serilog" for logging, configure it in the corresponding section; otherwise, leave it as is.

Running the Web Application

  1. Start the "Web application" from your IIS web server.
  2. Navigate to the configured URL. If the setup is correct, the application will open.