{"id":43153925,"url":"https://github.com/manwwe/rancher-minikube","last_synced_at":"2026-04-24T23:32:19.640Z","repository":{"id":274382532,"uuid":"922729083","full_name":"manwwe/rancher-minikube","owner":"manwwe","description":"🐳 Automated deployment of Rancher on a local Kubernetes cluster using Minikube and Helm for MacOS.","archived":false,"fork":false,"pushed_at":"2025-01-26T23:59:47.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-01T10:34:37.926Z","etag":null,"topics":["automation","containerization","devops","infrastructure-as-code","kubernetes","minikube","rancher"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manwwe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-26T23:50:03.000Z","updated_at":"2025-09-14T21:12:58.000Z","dependencies_parsed_at":"2025-01-27T00:25:17.895Z","dependency_job_id":"cd5f1b9b-2691-4b4c-9d4a-fab0768f377e","html_url":"https://github.com/manwwe/rancher-minikube","commit_stats":null,"previous_names":["fmgarciaa/rancher-minikube","dotfmg/rancher-minikube","manwwe/rancher-minikube"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/manwwe/rancher-minikube","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manwwe%2Francher-minikube","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manwwe%2Francher-minikube/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manwwe%2Francher-minikube/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manwwe%2Francher-minikube/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manwwe","download_url":"https://codeload.github.com/manwwe/rancher-minikube/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manwwe%2Francher-minikube/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31976805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T16:27:12.723Z","status":"ssl_error","status_checked_at":"2026-04-18T16:27:11.140Z","response_time":103,"last_error":"SSL_read: 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":["automation","containerization","devops","infrastructure-as-code","kubernetes","minikube","rancher"],"created_at":"2026-02-01T00:30:30.652Z","updated_at":"2026-04-18T17:02:12.637Z","avatar_url":"https://github.com/manwwe.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rancher-Minikube\n\nThis project automates the process of deploying Rancher in a local environment using **Minikube**. The script does the following:\n\n1. Verifies that the required commands (`minikube`, `kubectl`, `helm`) are installed.\n2. Starts Minikube if it's not running.\n3. Installs **cert-manager** using Helm.\n4. Deploys **Rancher** on a Kubernetes cluster managed by Minikube.\n\n**Note:** This setup is specifically configured for **MacOS**. It is necessary to enable the `chipmk/tap/docker-mac-net-connect` setting for Docker networking.\n\n## Requirements\n\nBefore running the script, ensure the following commands are installed on your local machine:\n\n- [Minikube](https://minikube.sigs.k8s.io/docs/)\n- [Kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)\n- [Helm](https://helm.sh/docs/intro/install/)\n- **Docker** installed and running (MacOS).\n\nAdditionally, to ensure Docker networking works correctly with Minikube, **enable the Docker Mac networking connection** by running the following commands in your terminal:\n\n1. Install `docker-mac-net-connect` using **Homebrew**:\n\n   ```bash\n   brew install chipmk/tap/docker-mac-net-connect\n   ```\n\n2. Start the `docker-mac-net-connect` service:\n\n   ```bash\n   sudo brew services start chipmk/tap/docker-mac-net-connect\n   ```\n\nThese steps will set up the necessary networking configuration for Minikube to work properly with Docker on MacOS.\n\n## Usage Instructions\n\n1. **Clone the repository** or download the script.\n\n   ```bash\n   git clone https://github.com/fmgarciaa/rancher-minikube.git\n   cd rancher-minikube\n   ```\n\n2. **Run the deployment script**:\n\n   Make sure the script has execution permissions. If not, assign them with the following command:\n\n   ```bash\n   chmod +x ./scripts/setup.sh\n   ```\n\n   Then, run the script with:\n\n   ```bash\n   ./scripts/setup.sh\n   ```\n\n   The script will perform the following actions:\n\n   - It will check if **minikube**, **kubectl**, and **helm** are installed.\n   - It will start Minikube if it’s not already running.\n   - It will install **cert-manager** using Helm.\n   - It will deploy **Rancher** to your Minikube cluster.\n\n3. **Minikube Configuration**:\n\n   If Minikube is not running, the script will start it with the following configuration:\n\n   - Driver: `docker`\n   - Kubernetes version: `v1.31.0`\n   - Memory: `4096MB`\n   - CPUs: `4`\n   - It will enable the `ingress` and `ingress-dns` addons.\n\n4. **Access Rancher**:\n\n   Once Rancher is installed, you can access its web interface. To get the access URL, run the following command:\n\n   ```bash\n   kubectl get ingress -n cattle-system\n   ```\n\n   This will provide the public URL where Rancher will be available.\n\n   Note: Rancher may take several minutes to fully initialize as certificates are being issued, containers are starting, and the ingress rule is coming up.\n\n## Customization\n\nIf you need to customize the Rancher installation values, you can modify the `values.yaml` file. This file is used during the Rancher installation to set additional configurations.\n\n## Cleanup\n\nIf you want to remove the entire stack, you can use the `cleanup.sh` script. This script will:\n\n- Uninstall **Rancher**.\n- Remove the **cert-manager**.\n- Stop and delete the **Minikube** cluster.\n\nTo run the cleanup script, use the following steps:\n\n1. Ensure the script has execution permissions:\n\n   ```bash\n   chmod +x ./scripts/cleanup.sh\n   ```\n\n2. Run the script:\n\n   ```bash\n   ./scripts/cleanup.sh\n   ```\n\n   This will clean up the resources and stop the Minikube cluster.\n\n## Troubleshooting\n\nIf you encounter issues during script execution, check the following:\n\n- Ensure you have enough memory and CPU on your machine to run Minikube.\n- If the script fails to install **cert-manager** or **Rancher**, make sure Helm is properly configured and the repositories are up to date.\n- You can check the logs of Minikube and Kubernetes pods with the following commands:\n\n  ```bash\n  minikube logs\n  kubectl logs \u003cpod-name\u003e -n cattle-system\n  ```\n\n## Contributions\n\nContributions are welcome. If you have improvements or fixes, please open a **pull request**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanwwe%2Francher-minikube","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanwwe%2Francher-minikube","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanwwe%2Francher-minikube/lists"}