---
title: "How to Deploy Syncfusion Spreadsheet Docker Image with ASP.NET Core 8.0"
published_at: "2025-08-19T16:40:51+00:00"
modified_at: "2026-07-01T10:52:06+00:00"
url: "https://www.syncfusion.com/blogs/post/spreadsheet-docker-image-deployment"
excerpt: "Deploy the Syncfusion Spreadsheet Docker image using ASP.NET Core 8.0 for scalable, Excel-like web apps. A step-by-step guide is included."
taxonomy_category:
  - "ASP.NET Core"
  - "Docker Deployment"
  - "Docker image"
  - "EJ2"
  - "Essential JS 2"
  - "Excel"
  - "JavaScript"
  - "Spreadsheet"
  - "Spreadsheet Integration"
  - "Web Development"
taxonomy_post_tag:
  - "ASP .NET Core 8.0"
  - "Client-side Integration"
  - "Developer Guide"
  - "Docker"
  - "EJ2 Spreadsheet"
  - "Excel-like UI"
  - "JavaScript"
  - "JavaScript Library"
  - "Spreadsheet"
  - "Web API"
---

# How to Deploy Syncfusion Spreadsheet Docker Image with ASP.NET Core 8.0

[Sastha Prathap](https://www.syncfusion.com/blogs/author/sastha-prathap-selvamoorthy)

![How to Deploy Syncfusion Spreadsheet Docker Image with ASP.NET Core 8.0](https://www.syncfusion.com/blogs/wp-content/uploads/2025/08/How-to-Deploy-Syncfusion-Spreadsheet-Docker-Image-with-ASP.NET-Core-8.0.jpg)


**TL;DR:** Learn how to deploy the Syncfusion® EJ2 Spreadsheet image using Docker and ASP.NET Core 8.0. This guide simplifies backend setup and connects your client-side app to a scalable, Excel-like spreadsheet API.

The [ASP .NET Core Spreadsheet](https://www.syncfusion.com/spreadsheet-editor-sdk/asp-net-core-spreadsheet-editor)
 is a powerful, Excel-like UI component that enables developers to build rich, interactive spreadsheet experiences in web applications. With features like data binding, formatting, Excel import/export, and more, it delivers seamless spreadsheet functionality across platforms.

Developers often struggle with backend setup when integrating Excel-like functionality into web apps. The Syncfusion® EJ2 Spreadsheet **Docker image** solves this by offering a ready-to-deploy backend powered by ** ASP.NET Core 8.0**.

This guide walks you through deploying and integrating the Docker image with your client-side application.  
Add Excel-Like Spreadsheets to ASP.NET Core Apps

Embed powerful spreadsheet functionality into your ASP.NET Core apps with Syncfusion ASP.NET Core Spreadsheet. Let users edit workbooks, apply formulas, format cells, and import or export Excel files with ease.

[Add ASP.NET Core Spreadsheet](https://www.syncfusion.com/spreadsheet-editor-sdk/asp-net-core-spreadsheet-editor)

## Prerequisites

Before you begin, ensure the following tools are installed and properly set up on your system:

- **Docker Desktop:** Compatible with both [Windows](https://hub.docker.com/editions/community/docker-ce-desktop-windows) and [macOS](https://docs.docker.com/desktop/install/mac-install/)
- [Download .NET 8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) SDK

Once these tools are installed, you’re ready to proceed with the full deployment workflow.

## Quick start: Deployment via Docker Hub

### Step 1: Pull the Docker image

Open your terminal and pull the official Syncfusion® Spreadsheet server image:

```
docker pull syncfusion/spreadsheet-server
```

### Step 2: Create a Docker Compose file

Create a **docker-compose.yml** file in your project directory with the following content:

```
version: '3.4' 

services:
  spreadsheet-server:
    image: syncfusion/spreadsheet-server
    environment:
      
# Provide your license key for activation
      SYNCFUSION_LICENSE_KEY: YOUR_LICENSE_KEY
    ports:
      - "6002:8080"
```

**Note:** Syncfusion® Spreadsheet is a commercial product. You must provide a valid license key to run it in production. Replace **YOUR_LICENSE_KEY** with your actual key.

### Step 3: Start the Docker Container

Navigate to the directory containing your **docker-compose.yml** and run:

```
docker-compose up
```

Once running, the Spreadsheet server APIs will be available at:

- **Open API:**[http://localhost:6002/api/spreadsheet/open](http://localhost:6002/api/spreadsheet/open)
- **Save API:**[http://localhost:6002/api/spreadsheet/save](http://localhost:6002/api/spreadsheet/save)

### Step 4: Connect the Client-Side Spreadsheet

In your client-side app (**JavaScript**, ** React**, ** Angular**, ** Vue**, ** ASP.NET Core**, and ** ASP.NET MVC**), configure the Spreadsheet component to use the Docker-hosted API:

```
<SpreadsheetComponent 
  openUrl='http://localhost:6002/api/spreadsheet/open' 
  saveUrl='http://localhost:6002/api/spreadsheet/save'/>
```

## Configure culture preferences in Docker Compose

By default, the Spreadsheet Docker container uses the **en_US culture**. To change it, set the ** LC_ALL, LANGUAGE,**and ** LANG** environment variables in your ** docker-compose.yml** file. These values configure the server to run with the specified locale.

Here’s an example that sets the culture to **German (de_DE.UTF-8)**:

```
version: '3.4' 

services:
  spreadsheet-server:
    image: syncfusion/spreadsheet-server
    environment:
      
# Provide your license key for activation
      SYNCFUSION_LICENSE_KEY: YOUR_LICENSE_KEY
      
# Specify the culture to configure for the Spreadsheet server
      LC_ALL: de_DE.UTF-8
      LANGUAGE: de_DE.UTF-8
      LANG: de_DE.UTF-8
    ports:
      - "6002:8080"
```

## Customize & build Spreadsheet Docker image locally

Create your own Docker image if you want to add or customize functionalities.

### Step 1: Set up your development environment

Make sure Docker Desktop and .NET 8.0 SDK are installed.

### Step 2: Clone the Docker service app

Clone or download the **Docker service application** from [GitHub](https://github.com/SyncfusionExamples/Spreadsheet-Server-Docker)
.

### Step 3: Build and run the Docker image

Open a terminal in the root folder of the sample and run the commands below.

```
docker build -t spreadsheet-image
docker run -d -p 6002:8080 --name spreadsheet-container spreadsheet-image
```

### Step 4: (Optional) Use Docker Compose

Instead of manually running the container, you can use Docker Compose:

- Open a terminal in the root folder of the Docker sample.
- Build the image:``` docker build -t spreadsheet-image ```
- Create a **docker-compose.yml** file:``` version: '3.4' services: spreadsheet-container: image: spreadsheet-image environment: # Provide your license key for activation SYNCFUSION_LICENSE_KEY: YOUR_LICENSE_KEY ports: - "6002:8080" ```
- Run the service:``` docker-compose up ```

### Step 5: Connect the client app

Ensure your client app uses the correct API endpoints:

```
openUrl: 'http://localhost:6002/api/spreadsheet/open',                                                           
saveUrl: 'http://localhost:6002/api/spreadsheet/save',
```

## Conclusion

Deploying the [Syncfusion® EJ2 Spreadsheet](https://www.syncfusion.com/javascript-ui-controls/js-spreadsheet)
 backend using Docker and ASP.NET Core 8.0 provides a scalable and modular solution for enterprise-grade spreadsheet applications. By leveraging Docker Compose, developers can configure culture settings, manage environment variables (including license keys), and streamline deployment across environments. This setup ensures a smooth and consistent experience whether you’re using [JavaScript](https://ej2.syncfusion.com/documentation/spreadsheet/docker-deployment)
, [React](https://ej2.syncfusion.com/react/documentation/spreadsheet/docker-deployment)
, [Angular](https://ej2.syncfusion.com/angular/documentation/spreadsheet/docker-deployment)
, [Vue](https://ej2.syncfusion.com/vue/documentation/spreadsheet/docker-deployment)
, [ASP.NET Core](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/docker-deployment)
 or [ASP.NET MVC](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/docker-deployment)
.

For more platform-specific guides, check out our Open and Save functionality tutorials below:

- [JavaScript](https://ej2.syncfusion.com/documentation/spreadsheet/open-save)
- [Angular](https://ej2.syncfusion.com/angular/documentation/spreadsheet/open-save)
- [React](https://ej2.syncfusion.com/react/documentation/spreadsheet/open-save)
- [Vue](https://ej2.syncfusion.com/vue/documentation/spreadsheet/open-save)
- [ASP.NET Core](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/open-save)
- [ASP.NET MVC](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/open-save)

Customers with an active license can download the latest release of Essential Studio® from the [license and downloads page](https://www.syncfusion.com/account/login)
. New users are invited to start a [30-day free trial](https://www.syncfusion.com/downloads)
 to explore the latest features.

Need help? Reach out through our [support forum](https://www.syncfusion.com/forums)
, [support portal](https://support.syncfusion.com/)
, or [feedback portal](https://www.syncfusion.com/feedback)
. We’re here to help you build modern, feature-rich applications with confidence and ease.

## Related Blogs



[Host Open and Save Services for JavaScript Spreadsheet with ASP.NET Core and Docker](https://www.syncfusion.com/blogs/post/host-spreadsheet-open-and-save-services)



[Simple Steps to Validate Data in a JavaScript Spreadsheet](https://www.syncfusion.com/blogs/post/simple-steps-to-validate-data-in-a-javascript-spreadsheet)



[Introducing the Blazor Spreadsheet: Excel-Like Power for Your Web Apps](https://www.syncfusion.com/blogs/post/excel-like-blazor-spreadsheet)



[Introducing JavaScript Spreadsheet in Essential JS 2](https://www.syncfusion.com/blogs/post/introducing-javascript-spreadsheet)
