Local Workstation

A local workstation runs on your development machine as a Lima VM, giving you a reproducible environment without needing cloud resources.

Note: Local workstations are currently only supported on macOS. Support for Windows and Linux is coming soon.

Prerequisites

Create a Local Workstation

Create a manifest file for your workstation:

# my-workstation.yaml
# Supported OS: ubuntu-24.04, debian-13
apiVersion: werkr.dev/v1alpha1
kind: Workstation
metadata:
  name: my-local-dev
  labels:
    team: platform
spec:
  os:
    id: ubuntu-24.04
  provider: lima
  resources:
    cpu: 4
    memory: 3
    diskSize: 50

Apply it:

wer apply -f my-workstation.yaml

Connect to Your Workstation

Open a shell session:

wer shell --name my-local-dev

Or connect to a persistent tmux session:

wer tmux --name my-local-dev

Manage Lifecycle

# Stop the workstation
wer stop workstation my-local-dev

# Start it again
wer start workstation my-local-dev

# Delete it
wer delete workstation my-local-dev

Next Steps

Learn how to create a remote workstation in the cloud, or explore configuration options to customize your environment.