# Kubernetes Pod

> The smallest thing Kubernetes runs. It wraps one container, or a few that work as one.

**Field:** Infrastructure  
**Category:** Container Orchestration  
**Also known as:** Pod, K8s Pod, Pod (Kubernetes)

## Think of it like

It is like a pea pod. Each pea is a container, and the pod holds them close together.

## Definition

A Kubernetes pod is the smallest thing Kubernetes runs. It wraps one container, or a few that must work side by side. The containers in a pod share one network address and can share storage. Pods are throwaway. When one dies, a new one with a new address takes its place. That is why you rarely make a pod by hand.

## Example

Emma's web pod holds the app container and a small helper that ships its logs. Both start together, stop together and share one address.

## Example code

```yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx
spec:
  containers:
  - name: nginx
    image: nginx:1.14.2
    ports:
    - containerPort: 80
```

A pod with one container in it. In real work, a deployment makes pods like this for you.

## Why it matters

Every app in Kubernetes runs inside pods. Knowing that they come and go explains most of how Kubernetes works.

## Common mistake

Putting several unrelated apps in one pod. They then grow, fail and restart as one, when each should stand alone.

## Three principles

- **Smallest unit.** Kubernetes places pods, not loose containers.
- **Shared address.** Containers in a pod share one network address.
- **Throwaway.** Dead pods are replaced, not repaired.

## Related terms

- [Container](https://learn.benibix.com/term/infrastructure/container)
- [Kubernetes Deployment](https://learn.benibix.com/term/infrastructure/kubernetes-deployment)
- [Kubernetes Node](https://learn.benibix.com/term/infrastructure/kubernetes-node)
- [Kubernetes Service](https://learn.benibix.com/term/infrastructure/kubernetes-service)
- [Kubernetes (K8s)](https://learn.benibix.com/term/infrastructure/kubernetes)
- [Podman](https://learn.benibix.com/term/infrastructure/podman)

## Told apart from

- [Kubernetes Pod vs Container](https://learn.benibix.com/compare/kubernetes-pod-vs-container): People think a pod is just the Kubernetes word for a container, and it is not. A pod is a wrapper around one container or a few. The containers in one pod share an address and start and stop together. Kubernetes places and replaces pods, never loose containers. Most pods hold one container, which is why the two get mixed up.

![A large box marked cluster. At the top sits the control plane. Below it are three nodes in a row. Each node holds pods, and each pod holds one or two containers. On the left, outside the cluster, a person types kubectl commands, and an arrow runs from them to the control plane.](https://learn.benibix.com/diagrams/inf-k8s-cluster.svg)

---

Source: https://learn.benibix.com/term/infrastructure/kubernetes-pod
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
