coder/examples/lima/README.md

name	description	tags
Run Coder in Lima	Quickly stand up Coder using Lima	local docker vm lima

Run Coder in Lima

This provides a sample Lima configuration for Coder. This lets you quickly test out Coder in a self-contained environment.

Prerequisite: You must have lima installed and available to use this.

Getting Started

• Run limactl start --name=coder https://raw.githubusercontent.com/coder/coder/main/examples/lima/coder.yaml
• You can use the configuration as-is, or edit it to your liking.

This will:

• Start an Ubuntu 22.04 VM
• Install Docker and Terraform from the official repos
• Install Coder using the installation script
• Generates an initial user account admin@coder.com with a randomly generated password (stored in the VM under /home/${USER}.linux/.config/coderv2/password)
• Initializes a sample Docker template for creating workspaces

Once this completes, you can visit http://localhost:3000 and start creating workspaces!

Alternatively, enter the VM with limactl shell coder and run coder templates init to start creating your own templates!

Further Information

• To learn more about Lima, visit the the project's GitHub page.