Local Workstation

A local workstation runs on your development machine. werkr provisions it using Docker containers, giving you a reproducible environment without needing cloud resources.

Prerequisites

• werkr CLI installed (installation guide)
• Docker installed and running

Create a Local Workstation

Create a manifest file for your workstation:

# my-workstation.yaml
apiVersion: werkr.dev/v1alpha1
kind: Workstation
metadata:
  name: my-local-dev
  labels:
    shell: zsh
spec:
  os:
    id: debian-13
  provider: docker

Apply it:

wer apply -f my-workstation.yaml

Connect to Your Workstation

Open a shell session:

wer shell my-local-dev

Or connect to a persistent tmux session:

wer tmux my-local-dev

Manage Lifecycle

# Stop the workstation
wer stop my-local-dev

# Start it again
wer start my-local-dev

# Delete it
wer delete my-local-dev

Next Steps

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