What Happened?
What would you like to be added?
A new tutorial in the official Minikube docs covering how to run Minikube on a remote cloud VM, with AWS EC2 as the reference setup.
Why is this needed?
There is currently no official Minikube tutorial covering setup on a remote cloud VM (EC2, GCP Compute Engine, Azure VM, etc.), despite this being a common workflow for users who:
- Don't want to use (or can't license) Docker Desktop locally
- Use a remote dev box as their primary development environment
- Want to experiment with Kubernetes without consuming local laptop resources
The official docs touch on the --listen-address flag briefly in the FAQ, but there is no end-to-end walkthrough.
Evidence of demand: numerous third-party guides exist (Medium, dev.to, plainenglish.io, etc.) for "Minikube on EC2." Each is slightly different, sometimes outdated, and none are authoritative. A first-party tutorial would consolidate and replace these.
Proposed scope
A single page in site/content/en/docs/tutorials/ covering:
- Prerequisites and instance sizing (why
t2.micro fails with "Requested cpu count 1 is less than the minimum allowed of 2", t3.medium as the practical minimum)
- Installing Docker + Minikube on Ubuntu EC2
- Starting Minikube with
--driver=docker
- Accessing services from outside the VM (e.g.
kubectl port-forward + SSH tunnel pattern)
- Troubleshooting common issues:
ErrImageNeverPull and the minikube image load workaround
- Memory/CPU sizing errors
- Service access from outside the VM
- Cost note: stopping the EC2 instance when not in use
Scope is intentionally limited to AWS EC2 to keep the tutorial focused. A follow-up could generalize to other cloud providers if maintainers want.
Additional context
I'd like to write this PR myself. I've been running Minikube on AWS EC2 (Ubuntu, t3.medium) as part of my Kubernetes learning journey and hit each of the gotchas listed above firsthand.
Could a maintainer confirm:
- Is this addition welcome in the official docs?
- Is
site/content/en/docs/tutorials/ the right location?
- Is the proposed scope appropriate, or would you prefer it broader (multi-cloud) / narrower (troubleshooting only)?
Once confirmed, I'll open a PR with the draft tutorial. Thanks!
Attach the log file
N/A — this is a documentation request, not a bug report. Logs are not applicable. Please see "What Happened?" field above for the full request.
Operating System
Ubuntu
Driver
Docker
What Happened?
What would you like to be added?
A new tutorial in the official Minikube docs covering how to run Minikube on a remote cloud VM, with AWS EC2 as the reference setup.
Why is this needed?
There is currently no official Minikube tutorial covering setup on a remote cloud VM (EC2, GCP Compute Engine, Azure VM, etc.), despite this being a common workflow for users who:
The official docs touch on the
--listen-addressflag briefly in the FAQ, but there is no end-to-end walkthrough.Evidence of demand: numerous third-party guides exist (Medium, dev.to, plainenglish.io, etc.) for "Minikube on EC2." Each is slightly different, sometimes outdated, and none are authoritative. A first-party tutorial would consolidate and replace these.
Proposed scope
A single page in
site/content/en/docs/tutorials/covering:t2.microfails with "Requested cpu count 1 is less than the minimum allowed of 2",t3.mediumas the practical minimum)--driver=dockerkubectl port-forward+ SSH tunnel pattern)ErrImageNeverPulland theminikube image loadworkaroundScope is intentionally limited to AWS EC2 to keep the tutorial focused. A follow-up could generalize to other cloud providers if maintainers want.
Additional context
I'd like to write this PR myself. I've been running Minikube on AWS EC2 (Ubuntu, t3.medium) as part of my Kubernetes learning journey and hit each of the gotchas listed above firsthand.
Could a maintainer confirm:
site/content/en/docs/tutorials/the right location?Once confirmed, I'll open a PR with the draft tutorial. Thanks!
Attach the log file
N/A — this is a documentation request, not a bug report. Logs are not applicable. Please see "What Happened?" field above for the full request.
Operating System
Ubuntu
Driver
Docker