---
title: "💭 Quick-Start Guide | K3s"
description: "!https://docs.k3s.io/quick-start"
date: 2023-10-20
published: true
tags:
  - homelab
  - k3s
  - thought
template: link
---


<div class="embed-card embed-card-external">
  <a href="https://docs.k3s.io/quick-start" class="embed-card-link" target="_blank" rel="noopener noreferrer">
    <div class="embed-card-content">
      <div class="embed-card-title">Quick-Start Guide | K3s</div>
      <div class="embed-card-description">This guide will help you quickly launch a cluster with default options. Make sure your nodes meet the requirements before proceeding.</div>
      <div class="embed-card-meta">docs.k3s.io</div>
    </div>
  </a>
</div>


I recently spun up k3s in my homelab.  I'm trying to offload some work off of my free tier fly.io app in order to keep it free tier without crashing.


``` bash
# install and start k3s
curl -sfL https://get.k3s.io | sh -
# check to see if your nodes are started
sudo kubectl get nodes
```

My main hiccup so far was the machine I am running on runs zfs on root, and it would not start the master node.  Rather than figuring out how to make zfs play nice I just pointed k3s to a drive that is not zfs.

``` bash
# manuallly
sudo k3s server -d /mnt/vault/.rancher/k3s
# without editing systemd service
sudo ln -s /mnt/vault/.rancher/k3s /var/lib/rancher/k3s
```

!!! note

    This post is a <a href="/thoughts/" class="wikilink" data-title="Thoughts" data-description="These are generally my thoughts on a web page or some sort of url, except a rare few don&#39;t have a link. These are dual published off of my..." data-date="2024-04-01">thought</a>. It's a short note that I make
    about someone else's content online <a href="/tags/thoughts/" class="hashtag-tag" data-tag="thoughts" data-count=2 data-reading-time=3 data-reading-time-text="3 minutes">#thoughts</a>
