---
title: "Quickstart"
description: "Create a new IceRPC application from scratch with a few simple commands."
url: https://docs.icerpc.dev/getting-started/quickstart
docs_index: https://docs.icerpc.dev/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.icerpc.dev/llms.txt).

# Quickstart

Create a new IceRPC application from scratch with a few simple commands.

This quickstart shows how to build and run a complete client-server application with IceRPC in just a few minutes.

Prerequisites: you just need to have the .NET 10 SDK installed on your computer.

The networked application we are building together consists of:

- a server that hosts a single service (a simple greeter service)
- a client that establishes a connection to the server and calls `greet` on this greeter service

The client and server are console applications that use plain .NET (no ASP.NET, no Dependency Injection).

Let's jump right in:

## Install the dotnet-new templates for IceRPC

```shell
dotnet new install IceRpc.Templates
```

## Create the server

We create the server application from the `icerpc-slice-server` template installed in the previous step:

```shell
dotnet new icerpc-slice-server -o MyServer
```

This command creates our new IceRPC + Slice server application in directory `MyServer`.

## Create the client

Similarly, we create the client application from a template:

```shell
dotnet new icerpc-slice-client -o MyClient
```

This command creates our new IceRPC + Slice client application in directory `MyClient`.

## Run the application

Now that we have created both the client and server applications, we can run them.

### Start the server

Open a terminal and run the server:

```shell
cd MyServer
dotnet run
```

The server is now listening for new connections from clients.

### Start the client

Open another terminal and run the client:

```shell
cd MyClient
dotnet run
```

The client sends a single `greet` request to the service hosted by our server:

```
info: IceRpc.Logger.LoggerInterceptor[0]
      Sent request greet to icerpc:/VisitorCenter.Greeter over [::1]:59739<->[::1]:4062 and received a response with status code Ok
Hello, jose!
```

## Next steps

Congratulations! You have successfully created your first IceRPC application.

You can learn more about what each file produced by the templates does in the Tutorial:

- [Writing your first IceRPC + Slice server application](https://docs.icerpc.dev/getting-started/icerpc-slice-tutorial/server-tutorial.md)
- [Writing your first IceRPC + Slice client application](https://docs.icerpc.dev/getting-started/icerpc-slice-tutorial/client-tutorial.md)
