{"id":36688778,"url":"https://github.com/converged-computing/usernetes-lima","last_synced_at":"2026-01-12T11:17:55.555Z","repository":{"id":207993917,"uuid":"720512255","full_name":"converged-computing/usernetes-lima","owner":"converged-computing","description":"Testing running usernetes in lima VMs","archived":false,"fork":false,"pushed_at":"2023-11-20T18:58:09.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-10T05:36:46.684Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/converged-computing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-11-18T17:59:49.000Z","updated_at":"2023-11-20T18:58:10.000Z","dependencies_parsed_at":"2023-11-19T00:24:11.597Z","dependency_job_id":"b15e498c-99b1-40c0-bf9d-ab86a3a6b997","html_url":"https://github.com/converged-computing/usernetes-lima","commit_stats":null,"previous_names":["converged-computing/usernetes-lima"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/converged-computing/usernetes-lima","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fusernetes-lima","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fusernetes-lima/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fusernetes-lima/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fusernetes-lima/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/converged-computing","download_url":"https://codeload.github.com/converged-computing/usernetes-lima/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/converged-computing%2Fusernetes-lima/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-12T11:17:54.794Z","updated_at":"2026-01-12T11:17:55.549Z","avatar_url":"https://github.com/converged-computing.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Usernetes Lima\n\nWe are going to test deploying usernetes with [Lima](https://lima-vm.io) as [suggested by Akihiro](https://github.com/rootless-containers/usernetes/pull/301#issuecomment-1802740742)!\n\n## Install\n\nTo install I did:\n\n```console\nVERSION=$(curl -fsSL https://api.github.com/repos/lima-vm/lima/releases/latest | jq -r .tag_name)\nwget \"https://github.com/lima-vm/lima/releases/download/${VERSION}/lima-${VERSION:1}-$(uname -s)-$(uname -m).tar.gz\"\ntar -xzvf lima-0.18.0-Linux-x86_64.tar.gz\n```\n\nThis extracts the bin and share in the present working directory to add to the path.\n\n```bash\nexport PATH=$PWD/bin:$PATH\n```\n\n**Note** that you need [QEMU](https://itsfoss.com/qemu-ubuntu/) installed!\nAnd note there are instructions for other platforms [here](https://lima-vm.io/docs/installation/)\n\n## RockyLinux\n\nIt looks like Akihiro suggested indirectly to start with Rocky Linux.\nWe will make a template that goes off of that!\n\n### Control Plane\n\n```bash\nlimactl start --network=lima:user-v2 --name=control-plane ./usernetes-control-plane.yaml\n```\n\nYou'll see an instruction to copy the contents of join-command into [usernetes-worker.yaml](usernetes-worker.yaml).\n\n```console\nINFO[0444] Message from the instance \"control-plane\":   \nTo setup a worker node, copy the contents of /home/vanessa/.lima/control-plane/join-command into the usernetes-worker.yaml\nblock **but do not commit**\n```\n\nThis should be copied into the last user block to write `/opt/usernetes/join-command`.\n\n### Worker\n\nNote that you'll need the [rust version](https://gitlab.com/virtio-fs/virtiofsd) of virtiofsd for this to work (the old C version with QEMU did not work for me). \n\n```bash\n# This is in the PWD\ngit clone https://gitlab.com/virtio-fs/virtiofsd \ncd virtiofsd \nsudo apt install libcap-ng-dev libseccomp-dev\n```\n\nThen build with cargo.\n\n```bash\ncargo build --release\n```\n\nThen I replaced it.\n\n```\nsudo mv /usr/lib/qemu/virtiofsd /usr/lib/qemu/virtiofsd-c\nsudo mv virtiofsd/target/release/virtiofsd /usr/lib/qemu/virtiofsd\n```\n\nI also did:\n\n```\nsudo usermod -aG kvm $USER\n```\n\nAfter copying the join command:\n\n```bash\nmkdir -p /tmp/lima\ncp /home/vanessa/.lima/control-plane/join-command /tmp/lima/join-command\n```\n\nlet's make one worker.\n\n```bash\nlimactl start --network=lima:user-v2 --name=usernetes-worker ./usernetes-worker.yaml\n```\n\nWe need to run join manually (containerd seems to have trouble starting before then)\n\n```bash\nlimactl shell --workdir /opt/usernetes usernetes-worker\ncd /opt/usernetes\nsudo systemctl containerd status\nsudo systemctl status containerd\nsudo systemctl start containerd\nmake -C /opt/usernetes up kubeadm-join\n```\n\nNote that sometimes I need to run this twice.\nThen exit and shell in to the control-plane again.\n\n```bash\nlimactl shell control-plane\n```\n\nThe `KUBECONFIG` should be exported so you can now see the node that was registered:\n\n```bash\n$ kubectl get nodes\nNAME           STATUS   ROLES           AGE     VERSION\nu7s-lima-vm0   Ready    control-plane   14h     v1.28.0\nu7s-lima-vm1   Ready    \u003cnone\u003e          6m51s   v1.28.0\n```\n\nTry creating a deployment:\n\n```bash\nkubectl apply -f ./scripts/my-echo.yaml\n```\n```bash\n$ kubectl get svc\nNAME         TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE\nkubernetes   ClusterIP      10.96.0.1       \u003cnone\u003e        443/TCP          14h\nmy-echo      LoadBalancer   10.96.150.133   \u003cpending\u003e     8080:31992/TCP   4s\n```\n```bash\n$ kubectl get pods\nNAME                       READY   STATUS    RESTARTS   AGE\nmy-echo-656f6949c4-v8b6q   1/1     Running   0          9s\n```\n\nWoot! \n\n## Clean Up\n\nYou can stop:\n\n```bash\nlimactl stop control-plane\nlimactl stop usernetes-worker\n```\n\nI haven't played around with restarting - likely services would need to be restarted, etc.\nIf you come back:\n\n```bash\nlimactl start --network=lima:user-v2 control-plane\nlimactl start --network=lima:user-v2 usernetes-worker\n```\n\nor just nuke it!\n\n```bash\nlimactl delete control-plane\nlimactl delete usernetes-worker\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconverged-computing%2Fusernetes-lima","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconverged-computing%2Fusernetes-lima","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconverged-computing%2Fusernetes-lima/lists"}