https://github.com/blacksmithop/homelab

Configuration for my homelab
https://github.com/blacksmithop/homelab

Last synced: 9 months ago
JSON representation

Configuration for my homelab

• Host: GitHub
• URL: https://github.com/blacksmithop/homelab
• Owner: blacksmithop
• Created: 2025-02-22T08:05:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-08-24T07:22:39.000Z (10 months ago)
• Last Synced: 2025-09-21T00:58:27.990Z (9 months ago)
• Language: Shell
• Size: 530 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Homelab

![Stack](https://skillicons.dev/icons?i=ubuntu,bash,py,cloudflare,nginx,vscode)

---

## FAQ

### How do I run my services?

I run them as Docker containers using `docker-compose`

### How do I connect to my homelab?

I use Tailscale for SSH & RDP connectivity

### How do I expose my services to the internet?

Cloudflare Tunnels behind an nginx reverse-proxy is used to expose services through subdomains

---

Expose your homelab server using Cloudflared Tunnels and Nginx

[![Cloudflare Tunnel and NPM Guide](https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=Udc6HeOqxCY&ab_channel=AbhinavKM) [![Medium Article](https://img.shields.io/badge/Medium-12100E?style=for-the-badge&logo=medium&logoColor=white)](https://medium.com/@angstycoder101/forget-the-cloud-run-your-own-server-with-cloudflare-tunnels-cb73cb5f18ab)

## Environment Setup

To setup the environment run the following commands

```bash

bash preinstall.sh

```

![Pre-install script](./data/assets/preinstall.svg)

Followed by

```

zsh run.sh

```

![Run script](./data/assets/run.svg)

## Update Services

```bash

bash update.sh

```

![Update script](./data/assets/update.svg)

## TODO:

* Dedicated wiki page

* Integrate dotfiles and zshrc

* CI/CD

* Bash script to automate setup

* Rust server https://github.com/samrocketman/docker-compose-lgsm-rust-dedicated-server/blob/main/docker-compose.yml