---
title: "Starting the IceBox Server"
url: https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Starting the IceBox Server

Parts of this page are for some programming languages only, and name them. For one language's text alone, see [C++](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/java.md), [JavaScript](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/php.md), [Python](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/ruby.md), and [Swift](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/swift.md).

Incorporating everything we discussed previously, we can now configure and start IceBox servers.

> **C++**
>
> The configuration file for our example C++ service is shown below:
>
> ```config
> IceBox.Service.Greeter=GreeterService:create --Ice.Trace.Dispatch
> ```
>
> Assuming this property resides in a configuration file named `config`, we can start the C++ IceBox server as follows:
>
> ```shell
> icebox --Ice.Config=config
> ```

> **C#**
>
> Build the service project before starting IceBox. The following configuration loads the example service from its .NET 8 Debug build:
>
> ```config
> IceBox.Service.Greeter=Service/bin/Debug/net8.0/GreeterService.dll:Service.GreeterService --Ice.Trace.Dispatch
> ```
>
> Save this property in a file named `config` in the directory that contains the `Service` project directory. In that directory, install the Ice 3.8 version of `iceboxnet` as a local tool, then start the IceBox server:
>
> ```shell
> dotnet tool install iceboxnet --version "3.8.*" --create-manifest-if-needed
> dotnet iceboxnet --Ice.Config=config
> ```

> **Java**
>
> The configuration file for our example Java service is shown below:
>
> ```config
> IceBox.Service.Greeter=com.example.icebox.greeter.service.GreeterService --Ice.Trace.Dispatch
> ```
>
> Assuming this property resides in a configuration file named `config`, we can start the Java IceBox server as follows:
>
> ```shell
> java com.zeroc.IceBox.Server --Ice.Config=config
> ```
>
> The class path must include the Ice and IceBox JAR files, as well as the service's classes.

## IceBox Server Failures

At startup, an IceBox server inspects its configuration for all properties having the prefix [IceBox.Service](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties.md#icebox.service.name) and initializes each service. If initialization fails for a service, the IceBox server invokes the `stop` operation on any initialized services, reports an error, and terminates.

## See Also

- [IceBox.\*](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties.md)
