Instances

Instances are virtual machines (VMs) that run on Bunker hypervisors.

Overview

A Bunker instance is a complete virtual machine with:

• An operating system (Linux, Windows)
• Dedicated resources (CPU, memory, storage)
• Network connectivity
• Console access

Lifecycle

Instance States

State	Description
CREATING	Instance is being created
RUNNING	Instance is running
STOPPED	Instance is stopped
ERROR	An error occurred

Resources

Each instance has configurable resources:

Resource	Description	Unit
vCPU	Virtual processors	Number of cores
Memory	Allocated RAM	GB
Storage	Primary disk	GB

Operations

Create an Instance

Via the Console or Control Plane API:

# gRPC API example
grpcurl -d '{
  "instance": {
    "name": "my-server",
    "machine_type": "n1-standard-2",
    "zone": "europe-west9-a"
  }
}' console.getbunker.net:443 \
  bunker.instances.v1.Instances/CreateInstance

Start / Stop

# Start
grpcurl -d '{"name": "instances/123"}' \
  console.getbunker.net:443 \
  bunker.instances.v1.Instances/StartInstance

# Stop
grpcurl -d '{"name": "instances/123"}' \
  console.getbunker.net:443 \
  bunker.instances.v1.Instances/StopInstance

Delete

grpcurl -d '{"name": "instances/123"}' \
  console.getbunker.net:443 \
  bunker.instances.v1.Instances/DeleteInstance

Templates

Instances are created from pre-configured templates:

• Ubuntu 22.04 LTS - Standard Linux server
• Ubuntu 24.04 LTS - Latest LTS version
• Debian 12 - Stable distribution
• Windows Server 2022 - Windows server

Metrics

The Control Plane collects metrics from each instance:

• CPU usage
• Memory usage
• Operational state

Next Steps

• Backups - Configure automatic backups
• Control Plane - Understand the management API