---
title: Server
summary: A server is an address (IP address or hostname) to which the Fastly Load Balancer service can forward requests. This service can define multiple servers and assign it to a pool. Fastly can then select any one of these servers based on a selection policy defined for the pool.
url: https://www.fastly.com/documentation/reference/api/load-balancing/pools/server
---

A server is an address (IP address or hostname) to which the Fastly Load Balancer service can forward requests. This service can define multiple servers and assign it to a pool. Fastly can then select any one of these servers based on a selection policy defined for the pool.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `address` | string | A hostname, IPv4, or IPv6 address for the server. Required. |
| `comment` | string | A freeform descriptive note. |
| `disabled` | boolean | Allows servers to be enabled and disabled in a pool. |
| `max_conn` | integer | Maximum number of connections. If the value is <code>0</code>, it inherits the value from pool's <code>max_conn_default</code>. |
| `override_host` | string | The hostname to override the Host header. Defaults to <code>null</code> meaning no override of the Host header if not set. This setting can also be added to a Pool definition. However, the server setting will override the Pool setting. |
| `port` | integer | Port number. Setting port <code>443</code> does not force TLS. Set <code>use_tls</code> in pool to force TLS. |
| `weight` | integer | Weight (<code>1-100</code>) used to load balance this server against others. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `id` | string | Alphanumeric string identifying a Server. (Read-only) |
| `pool_id` | string | Alphanumeric string identifying a Pool. (Read-only) |
| `service_id` | string | Alphanumeric string identifying the service. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### List servers in a pool

**GET** `/service/{service_id}/pool/{pool_id}/servers`

Lists all servers for a particular service and pool.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `pool_id` | string | path | Yes | Alphanumeric string identifying a Pool. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |

### Get a pool server

**GET** `/service/{service_id}/pool/{pool_id}/server/{server_id}`

Gets a single server for a particular service and pool.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `pool_id` | string | path | Yes | Alphanumeric string identifying a Pool. |
| `server_id` | string | path | Yes | Alphanumeric string identifying a Server. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |

### Update a server

**PUT** `/service/{service_id}/pool/{pool_id}/server/{server_id}`

Updates a single server for a particular service and pool.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `pool_id` | string | path | Yes | Alphanumeric string identifying a Pool. |
| `server_id` | string | path | Yes | Alphanumeric string identifying a Server. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |

### Delete a server from a pool

**DELETE** `/service/{service_id}/pool/{pool_id}/server/{server_id}`

Deletes a single server for a particular service and pool.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `pool_id` | string | path | Yes | Alphanumeric string identifying a Pool. |
| `server_id` | string | path | Yes | Alphanumeric string identifying a Server. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |

### Add a server to a pool

**POST** `/service/{service_id}/pool/{pool_id}/server`

Creates a single server for a particular service and pool.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `pool_id` | string | path | Yes | Alphanumeric string identifying a Pool. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |