added article for installation under linux

Author: nikola-yankov

net/getting-started/how-to-run-examples.md

@@ -2,7 +2,7 @@
 id: how-to-run-examples
 url: conversion/net/how-to-run-examples
 title: How to run examples
-weight: 6
+weight: 7
 description: "This article describes how to run .NET file conversion API code examples."
 keywords: file conversion, C#
 productName: GroupDocs.Conversion for .NET

net/getting-started/installation-linux.md

@@ -0,0 +1,89 @@
+---
+id: installation-linux
+url: conversion/net/installation-linux
+title: Install GroupDocs.Conversion for .NET on Linux
+linkTitle: Linux Installation
+weight: 5
+description: "Step-by-step guide to install and run GroupDocs.Conversion for .NET on Linux"
+keywords:
+productName: GroupDocs.Conversion for .NET
+hideChildren: False
+toc: True
+---
+
+This article explains how to install and run **GroupDocs.Conversion for .NET** on a Linux-based system using .NET Core or .NET 5/6+. It also includes instructions for installing native dependencies that might be required when running in a headless environment.
+
+## Prerequisites
+
+Ensure the following tools and packages are installed:
+
+- .NET 6.0 SDK or later: [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux)
+- A Linux distribution such as Ubuntu, Debian, CentOS, or Alpine
+- `libgdiplus` and other native dependencies
+
+To install the required packages:
+
+### Ubuntu / Debian:
+
+```bash
+sudo apt update
+sudo apt install -y libgdiplus libc6-dev libx11-dev libxext-dev libxrender-dev
+```
+
+### CentOS / RHEL:
+
+```bash
+sudo yum install -y libgdiplus libc6 libX11-devel libXext libXrender
+```
+
+### Alpine (Minimal Docker / Linux Distros):
+
+```bash
+apk add --no-cache libgdiplus fontconfig ttf-dejavu
+```
+
+> If using Alpine with Docker, check the [Build in Docker - Alpine Linux](https://docs.groupdocs.com/conversion/net/build-in-docker-alpine-linux/) article.
+
+## Install GroupDocs.Conversion using .NET CLI
+
+In your project directory, run:
+
+```bash
+dotnet add package GroupDocs.Conversion
+```
+
+To restore packages:
+
+```bash
+dotnet restore
+```
+
+## Run Your Project
+
+After adding the package and restoring dependencies, build and run your application:
+
+```bash
+dotnet run
+```
+
+## Headless Environments (Optional Fonts Setup)
+
+In Linux containers or headless setups, you may need additional fonts for proper document rendering:
+
+```bash
+sudo apt install -y fonts-dejavu fonts-liberation
+```
+
+You can also copy custom fonts to `/usr/share/fonts` or configure `FontSettings.SetFontsFolder` in code.
+
+## Troubleshooting
+
+- If you encounter `System.TypeInitializationException` or `System.DllNotFoundException`, ensure `libgdiplus` is installed.
+- If font rendering is broken or content is missing, install system fonts or configure a custom font folder.
+
+---
+
+For Docker setups, see:
+
+- [Build in Docker](https://docs-qa.groupdocs.com/conversion/net/build-in-docker/)
+- [Build in Docker - Alpine Linux](https://docs-qa.groupdocs.com/conversion/net/build-in-docker-alpine-linux/)

net/getting-started/licensing-and-subscription.md

@@ -2,7 +2,7 @@
 id: licensing-and-subscription
 url: conversion/net/licensing-and-subscription
 title: Licensing
-weight: 5
+weight: 6
 description: free conversion API version is available to evaluate the API which will be similar to licensed version but with few limitations.
 keywords: free conversion, license, conversion, API
 productName: GroupDocs.Conversion for .NET