Version v0.7 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.


A fast and easy way to deploy Kubeflow on your laptop

MiniKF latest

A production-ready, full-fledged, local Kubeflow deployment that installs in minutes.

MiniKF is a fast and easy way to get started with Kubeflow. With just a few clicks, you are up for experimentation, and for running complete Kubeflow Pipelines.

To train at scale, move to a Kubeflow cloud deployment with one click, without having to rewrite anything.

Please see the official announcement and the rationale behind MiniKF.

Join the discussion on the #minikf Slack channel, ask questions, request features, and get support for MiniKF.

To join the Kubeflow Slack workspace, please request an invite.

System requirements

For a smooth experience we recommend that your system meets the following requirements:

  • 12GB RAM
  • 2 CPUs
  • 50GB disk space

Operating systems

MiniKF runs on all major operating systems:

  • Linux
  • macOS
  • Windows


Before installing MiniKF, you need to have Vagrant and VirtualBox installed on your laptop.

MiniKF installation

Open a terminal on your laptop, create a new directory, switch into it, and run the following commands to install MiniKF:

vagrant init arrikto/minikf
vagrant up

MiniKF will take a few minutes to boot. When this is done, navigate to and follow the on-screen instructions to start Kubeflow and Rok.

MiniKF upgrade

Here are step-by-step instructions for upgrading from a previous version:

  1. Upgrade the MiniKF box to the latest version:

    vagrant box update
  2. Ensure you have updated to the latest version:

    vagrant box list
  3. Upgrade the vagrant-persistent-storage plugin to v0.0.47 or later:

    vagrant plugin update vagrant-persistent-storage
  4. Destroy the VM:

    vagrant destroy
  5. Remove all local state. This will remove all of your customization in MiniKF (notebooks, pipelines, Rok snapshots):

    • [Windows] del minikf-user-data.vdi
    • [Linux/macOS] rm minikf-user-data.vdi
  6. Re-create your VM:

    vagrant up

End-to-end example on MiniKF

Notebooks & Kubeflow Pipelines on the new MiniKF. Run an e2e ML pipeline following this tutorial.

Installation video

Here is a demo of installing MiniKF from scratch: