Create Excel (XLSX) or PDF file on Linux or macOS
GemBox.Spreadsheet is a standalone .NET component with cross-platform support, it can be used on non-Windows platforms like Linux and macOS.
The following example shows how you can create an Excel workbook and a PDF file using GemBox.Spreadsheet on Linux (Ubuntu).

Prerequisites
- Install Visual Studio Code.
- Install C# for Visual Studio Code extension.
- Install .NET Core SDK on Ubuntu.
After installing the requirements listed above you can follow these steps that show how you can easily use a Visual Studio Code (VS Code) to create a simple Console project and a C# code that generates a XLSX file.
1. Open a project folder
- Open VS Code.
- Click "Open Folder" on the EXPLORER panel.
- Select the folder you want your console project to be in, for instance a folder named GemBoxExample.

2. Create a new console project
- Open Integrated Terminal in VS Code by clicking "View" > "Terminal" or using CTRL + ` shortcut.
- In the terminal window execute following command:
dotnet new console
- This command will create a code file (Program.cs) and a project file (GemBoxExample.csproj) inside the opened folder.

3. Edit project files
- Add a reference to GemBox.Spreadsheet and its dependencies in GemBoxExample.csproj file:
<ItemGroup> <PackageReference Include="GemBox.Spreadsheet" Version="*" /> <PackageReference Include="HarfBuzzSharp.NativeAssets.Linux" Version="*" /> <PackageReference Include="SkiaSharp.NativeAssets.Linux" Version="*" /> </ItemGroup>
- Edit C# code in Program.cs file:
using GemBox.Spreadsheet; class Program { static void Main() { // If using the Professional version, put your serial key below. SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY"); ExcelFile workbook = new ExcelFile(); ExcelWorksheet worksheet = workbook.Worksheets.Add("Sheet1"); ExcelCell cell = worksheet.Cells["A1"]; cell.Value = "Hello World!"; workbook.Save("HelloWorld.xlsx"); } }
4. Run the console project
- In the terminal window execute following command:
dotnet run
- This command will run your Console application and create an Excel workbook (HelloWorld.xlsx) that you can open in any Excel application.

Limitations on Linux or macOS
You can use the full functionality of GemBox.Spreadsheet on Unix systems, but with the following exceptions:
- Printing workbooks.
- Saving workbooks to XPS and image formats.
- Saving charts to XPS and image formats.
- Calling
ConvertToImageSource
andConvertToXpsDocument
methods.
These features currently have WPF dependencies which means they require a .NET Windows Desktop Runtime. However, we do have plans for providing cross-platform support for them in future releases.