From 500f0afe29a99b1a3ccc61e8ef53b1d84047ebe0 Mon Sep 17 00:00:00 2001 From: Arpad Krejczinger Date: Tue, 19 Aug 2025 22:05:35 +0200 Subject: [PATCH] Update README with current homelab service status MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Mark all major services as completed (file server, media server, SSL) - Update repository structure with new config directories - Fix troubleshooting documentation references - Reflect current working state of homelab setup 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- README.md | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 2a14ae6..f54320a 100644 --- a/README.md +++ b/README.md @@ -7,10 +7,12 @@ Setting up a personal homelab using a ThinkPad laptop running Arch Linux to move - [x] Linux installation (Arch Linux on ThinkPad) - [x] SSH remote access (hostname: homelab) - [x] Dotfiles and development environment setup -- [x] Network domain setup -- [ ] Self-hosted cloud storage (ownCloud/Nextcloud) -- [x] Self-hosted git repository (Gitea/Forgejo/GitLab) +- [x] Network domain setup with SSL certificates +- [x] Self-hosted file server with WebDAV (copyparty) +- [x] Self-hosted git repository (Gitea) +- [x] Self-hosted media server (Jellyfin) - [x] AI voice assistant (local TTS with Piper) +- [x] Reverse proxy with nginx for multiple services - [ ] Gradual migration from commercial cloud services ## Hardware @@ -28,10 +30,13 @@ Setting up a personal homelab using a ThinkPad laptop running Arch Linux to move - ✅ SSH access configured (accessible as `homelab`) - ✅ Dotfiles management with yadm configured and merged - ✅ Development environment setup completed -- ✅ Network domain setup (DuckDNS + Nginx reverse proxy) +- ✅ Network domain setup (DuckDNS + Nginx reverse proxy + SSL) - ✅ Gitea Git server running (Docker container) +- ✅ Copyparty file server with working WebDAV support +- ✅ Jellyfin media server (Docker container) - ✅ AI voice assistant with local TTS (Piper + FastAPI) -- Next: SSL certificates, additional self-hosted services +- ✅ All services accessible via HTTPS with proper SSL certificates +- Next: Additional self-hosted services, backup solutions ## Documentation Structure @@ -41,7 +46,7 @@ Setting up a personal homelab using a ThinkPad laptop running Arch Linux to move 3. **Services**: Plan and deploy applications from [docs/services.md](docs/services.md) 4. **Voice Assistant**: Set up AI voice capabilities with [docs/voice-assistant.md](docs/voice-assistant.md) 5. **Tasks**: Track progress in [TODO.md](TODO.md) -6. **Issues**: Find solutions in [docs/troubleshooting.md](docs/troubleshooting.md) +6. **Issues**: Find solutions in [docs/troubleshooting/](docs/troubleshooting/) ### Repository Structure ``` @@ -53,10 +58,14 @@ homelab/ │ ├── network-security.md # SSH, DNS, VPN, firewall │ ├── services.md # Self-hosted services │ ├── voice-assistant.md # AI voice setup with Piper TTS -│ └── troubleshooting.md # Solutions & fixes +│ └── troubleshooting/ # Solutions & troubleshooting guides ├── config/ # Configurations & scripts │ ├── docker/gitea/ # Gitea container setup +│ ├── docker/jellyfin/ # Jellyfin media server setup +│ ├── docker/nextcloud/ # Nextcloud config (tested but disabled) +│ ├── copyparty/ # Copyparty file server configuration │ ├── nginx/ # Reverse proxy configs +│ ├── www/ # Landing page HTML │ └── scripts/ # Utility scripts ├── voice-server/ # AI voice assistant server │ ├── src/voice_server/ # FastAPI application @@ -73,11 +82,12 @@ homelab/ - **[docs/services.md](docs/services.md)** - Self-hosted services: Git hosting, cloud storage, media server - **[docs/voice-assistant.md](docs/voice-assistant.md)** - AI voice assistant setup with Piper TTS and FastAPI - **[TODO.md](TODO.md)** - Centralized task list with progress tracking by category -- **[docs/troubleshooting.md](docs/troubleshooting.md)** - Hardware issues, software problems, and solutions +- **[docs/troubleshooting/](docs/troubleshooting/)** - Hardware issues, software problems, and solutions + - **[docs/troubleshooting/webdav-copyparty.md](docs/troubleshooting/webdav-copyparty.md)** - WebDAV troubleshooting guide ### Current Configuration - **System**: Arch Linux with XFCE desktop, ter-124b TTY font, Colemak layout - **Network**: Static IP (192.168.0.100), SSH port 2222, DuckDNS (ak-homelab.duckdns.org) -- **Services**: Nginx reverse proxy, Gitea Git server (Docker), AI voice assistant (Piper TTS) -- **Security**: SSH hardened, firewall planned, SSL certificates pending +- **Services**: Nginx reverse proxy, Gitea Git server, Copyparty file server with WebDAV, Jellyfin media server, AI voice assistant +- **Security**: SSH hardened, SSL certificates active, WebDAV authentication enabled - **Development**: yadm dotfiles, tmux with temperature monitoring, zsh with proper history