Install the Knative quickstart plugin¶

This quickstart plugin provides a simplified Knative installation on a kind or Minikube Kubernetes cluster running locally on a single computer. This installation is well suited for experimentation.

This installation requires the following prerequisites:

The CLI Tools are installed.
Sufficient hardware:

6 CPUs, 6 GB of memory, and 30 GB of disk storage.

For information on production installs, see the Installation Roadmap.

Install the Knative quickstart plugin¶

To get started, install the Knative quickstart plugin:

Using HomebrewUsing a binaryUsing Go

Do one of the following:

To install the quickstart plugin by using Homebrew, run the command (Use brew upgrade instead if you are upgrading from a previous version):
```
brew install knative-extensions/kn-plugins/quickstart
```

Download the binary for your system from the quickstart release page.
Rename the file to remove the OS and architecture information. For example, rename kn-quickstart-amd64 to kn-quickstart.
Make the plugin executable. For example, chmod +x kn-quickstart.
Move the executable binary file to a directory on your PATH by running the command:
```
mv kn-quickstart /usr/local/bin
```
Verify that the plugin is working by running the command:
```
kn quickstart --help
```

Check out the kn-plugin-quickstart repository:

git clone https://github.com/knative-extensions/kn-plugin-quickstart.git
cd kn-plugin-quickstart/

Build an executable binary:
```
hack/build.sh
```
Move the executable binary file to a directory on your PATH by running the command:
```
mv kn-quickstart /usr/local/bin
```
Verify that the plugin is working by running the command:
```
kn quickstart --help
```

Run the Knative quickstart plugin¶

The quickstart plugin completes the following functions:

Checks if you have the selected Kubernetes instance installed
Creates a cluster called knative
Installs Knative Serving with Kourier as the default networking layer, and sslip.io as the DNS
Installs Knative Eventing and creates an in-memory Broker and Channel implementation

To get a local deployment of Knative, run the quickstart plugin:

Using kindUsing minikube

Install Knative and Kubernetes using kind by running:
```
kn quickstart kind
```
Note

Quickstart uses Port 80, and it will fail to install if any other services are bound on that port. If you have a service using Port 80, you'll need to stop it before using Quickstart. To check if another service is using Port 80:
```
netstat -tnlp | grep 80
```
After the plugin is finished, verify you have a cluster called knative:
```
kind get clusters
```

Install Knative and Kubernetes in a minikube instance by running:

Note

The minikube cluster will be created with 3 GB of RAM. You can change to a different value not lower than 3 GB by setting a memory config in minikube. For example, minikube config set memory 4096 will use 4 GB of RAM.
```
kn quickstart minikube
```
The output of the previous command asked you to run minikube tunnel. Run the following command to start the process in a secondary terminal window, then return to the primary window and press enter to continue:
```
minikube tunnel --profile knative
```
The tunnel must continue to run in a terminal window any time you are using your Knative quickstart environment.

The tunnel command is required because it allows your cluster to access Knative ingress service as a LoadBalancer from your host computer.

Note

To terminate the tunnel process and clean up network routes, enter Ctrl-C. For more information about the minikube tunnel command, see the minikube documentation.
After the plugin is finished, verify you have a cluster called knative:
```
minikube profile list
```

Next steps¶

Learn how to deploy your first Service in the Knative tutorial.
Try out Knative code samples.
See the Knative Serving and Knative Eventing guides.