---
title: ServiceSocket type | Wartiva GraphQL API
description: Socket configuration for launch-on-demand. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/service-socket.html
updated: 2026-10-07
---

Endpoint configuration · GraphQL type

# `ServiceSocket` type

Socket configuration for launch-on-demand.

## Fields

| Field Name | Description |
|---|---|
| `key` - [`String!`](https://wartiva.com/api-docs/types/string.html) | Socket identifier. |
| `sockType` - [`String`](https://wartiva.com/api-docs/types/string.html) | Socket type to create. Common values: "stream", "dgram", "seqpacket". |
| `sockPassive` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) | If true, create a listening socket. If false, create a connecting socket. |
| `sockNodeName` - [`String`](https://wartiva.com/api-docs/types/string.html) | Node name or address to connect or bind to. |
| `sockServiceName` - [`String`](https://wartiva.com/api-docs/types/string.html) | Service name or port on the node to connect or bind to. |
| `sockFamily` - [`String`](https://wartiva.com/api-docs/types/string.html) | Socket family, such as "IPv4", "IPv6", or "Unix". |
| `sockProtocol` - [`String`](https://wartiva.com/api-docs/types/string.html) | Protocol to use (e.g., "TCP"). |
| `sockPathName` - [`String`](https://wartiva.com/api-docs/types/string.html) | Path for a Unix domain socket. |
| `secureSocketWithKey` - [`String`](https://wartiva.com/api-docs/types/string.html) | Create a secure Unix domain socket and expose its path via an environment variable. |
| `sockPathMode` - [`Int`](https://wartiva.com/api-docs/types/int.html) | Permission mode for the socket (use decimal values). |
| `bonjour` - [`[String!]`](https://wartiva.com/api-docs/types/string.html) | Bonjour service names to advertise. |
| `multicastGroup` - [`String`](https://wartiva.com/api-docs/types/string.html) | Multicast group to join for datagram sockets. If an explicit IP address is provided, also set the socket family. |

## Used by

- [`SystemServiceMacOS`](https://wartiva.com/api-docs/types/system-service-mac-os.html) type: MacOS-specific attributes for a System Service.

## Example

### Example

```json
{
  "key": "xyz789",
  "sockType": "xyz789",
  "sockPassive": true,
  "sockNodeName": "xyz789",
  "sockServiceName": "xyz789",
  "sockFamily": "abc123",
  "sockProtocol": "xyz789",
  "sockPathName": "abc123",
  "secureSocketWithKey": "abc123",
  "sockPathMode": 123,
  "bonjour": ["xyz789"],
  "multicastGroup": "abc123"
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt