Files
homelab/README.md

2.4 KiB

Homelab Setup

Overview

Setting up a personal homelab using a ThinkPad laptop running Arch Linux to move away from cloud providers like Google.

Goals

  • Linux installation (Arch Linux on ThinkPad)
  • SSH remote access (hostname: homelab)
  • Dotfiles and development environment setup
  • Network domain setup
  • Self-hosted cloud storage (ownCloud/Nextcloud)
  • Self-hosted git repository (Gitea/Forgejo/GitLab)
  • Gradual migration from commercial cloud services

Hardware

  • Main Server: ThinkPad laptop
  • Development: Windows PC with WSL (for AI experimentation)
  • Android tablet: Not good for long-term work but can be useful for short SSH sessions
    • Runs Manjaro in a VM, same OS like the laptop

Inspiration & Resources

Current Status

  • Arch Linux installed on ThinkPad
  • SSH access configured (accessible as homelab)
  • Dotfiles management with yadm configured and merged
  • Development environment setup completed
  • Next: Network domain setup and self-hosted services

Documentation Structure

Quick Start Guide

  1. System Setup: Follow system-setup.md for Arch installation and configuration
  2. Network Security: Configure SSH, DNS, and VPN using network-security.md
  3. Services: Plan and deploy applications from services.md
  4. Tasks: Track progress in TODO.md
  5. Issues: Find solutions in troubleshooting.md

Documentation Files

  • system-setup.md - Complete Arch Linux installation, TTY config, desktop setup
  • network-security.md - SSH hardening, DuckDNS, WireGuard VPN, firewall setup
  • services.md - Self-hosted services: Git hosting, cloud storage, media server
  • TODO.md - Centralized task list with progress tracking by category
  • troubleshooting.md - Hardware issues, software problems, and solutions

Current Configuration

  • System: Arch Linux with XFCE desktop, ter-124b TTY font, Colemak layout
  • Security: SSH hardened, DuckDNS configured (ak-homelab.duckdns.org)
  • Development: yadm dotfiles, tmux with temperature monitoring, zsh with proper history