Documentation / Install guides

Install ASP.NET Core

A self-contained web sample with the package bundled.

1. Get the package

The download is public and needs no key — unlicensed output carries an evaluation watermark and nothing else is restricted. The package file is aspnet.zip.

Download aspnet

2. Check your platform

Two separate facts per platform: whether a licence key for this package covers it, and whether the download ships an engine binary for it.

Platform Licence covers it Binary in the download
win-x86 Yes Yes
win-x64 Yes Yes
win-arm64 Yes Yes
linux-x64 Yes Yes
linux-arm64 Yes Yes
macos Yes Yes

3. Install

shell
dotnet run --project LumasPdfWeb

4. Licence it

A licence is one key string, set once at startup. Buying one and installing it is covered by how licensing works; until then the engine runs fully functional with an evaluation watermark.

5. Your first PDF

The smallest complete program: create, write, close.

csharp
using System.Runtime.InteropServices;
using LumasPdfSdk;

app.MapGet("/hello", () =>
{
    // one engine instance per request: create, build, close, delete
    var pdf = LumasPdf.pdfNewPDF();
    try
    {
        LumasPdf.pdfCreateNewPDFW(pdf, "");   // empty name: build in memory
        LumasPdf.pdfAppend(pdf);
        LumasPdf.pdfSetFontW(pdf, "Helvetica", LumasPdfConsts.fsNone, 24, true, TCodepage.cp1252);
        LumasPdf.pdfWriteFTextW(pdf, LumasPdfConsts.taCenter, "Hello from LumasPDF");
        LumasPdf.pdfEndPage(pdf);
        LumasPdf.pdfCloseFile(pdf);

        uint len = 0;
        var buf = LumasPdf.pdfGetBuffer(pdf, ref len);
        var bytes = new byte[len];
        Marshal.Copy(buf, bytes, 0, (int)len);
        LumasPdf.pdfFreePDF(pdf);
        return Results.File(bytes, "application/pdf", "hello.pdf");
    }
    finally
    {
        LumasPdf.pdfDeletePDF(pdf);
    }
});

Where next