Update README with current homelab service status
- 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 <noreply@anthropic.com>
This commit is contained in:
30
README.md
30
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
|
||||
|
||||
Reference in New Issue
Block a user