homeserver

Manage and troubleshoot a NixOS home server with secure remote access and secret handling.

1|Updated Apr 23, 2025
One-click install
npx skills add https://github.com/pierreWagou/wagounix --skill homeserver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homeserver
Source: https://github.com/pierreWagou/wagounix/tree/main/.opencode/skills/homeserver
Command: npx skills add https://github.com/pierreWagou/wagounix --skill homeserver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill provides comprehensive management and troubleshooting guidance for the NixOS home server, enabling users to efficiently configure, secure, and diagnose their server environment.

Core Features & Use Cases

  • System Configuration: Guides setup of NixOS configurations, including hardware, services, and security settings.
  • Secret Management: Assists in encrypting, decrypting, and updating secrets with sops-nix and age keys.
  • Service Management: Supports deploying, updating, and troubleshooting containers, network services, and reverse proxies like Traefik and Traefik.
  • Remote Access: Facilitates secure SSH access, Tailscale VPN setup, and configuring DNS rewrites with AdGuard Home.
  • Security Hardening: Advises on SSH key setup, firewall rules, fail2ban, and TLS certificates.
  • Troubleshooting: Provides solutions for common issues such as container failures, DNS resolution problems, and tunnel connectivity issues.

Quick Start

Describe how to verify SSH access to the server and check service statuses for troubleshooting common connectivity issues.

Frequently Asked Questions about homeserver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot container failures and DNS resolution problems on a NixOS home server?

To troubleshoot NixOS home server issues, verify SSH access and check service statuses to diagnose container failures and DNS resolution problems. It provides specific solutions for common connectivity issues and service deployment errors.

What is the best way to manage secrets with sops-nix and age keys in NixOS?

Managing secrets in NixOS involves encrypting, decrypting, and updating secrets with sops-nix and age keys. This guides you through secure secret handling to maintain a resilient and protected self-hosted environment.

How do I configure secure remote SSH access and Tailscale VPN on NixOS?

Configuring secure remote access on NixOS requires setting up SSH keys and Tailscale VPN. This facilitates secure SSH access, Tailscale VPN setup, and DNS rewrites with AdGuard Home for network security.

Do I need knowledge of podman and sops to manage a NixOS home server?

Yes, managing a NixOS home server requires knowledge of NixOS, sops, podman, and network security best practices. This targets system administrators needing to maintain a secure self-hosted environment.

Why are my Traefik reverse proxy containers not deploying correctly in NixOS?

Traefik reverse proxy deployment issues in NixOS often stem from container failures or network service misconfigurations. This supports deploying, updating, and troubleshooting containers and reverse proxies.