systemd-services

Manage systemd user services for Node.js, Go binaries, and ttyd.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/MassimilianoPili/claude-code-config --skill systemd-services
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systemd-services
Source: https://github.com/MassimilianoPili/claude-code-config/tree/main/skills/systemd-services
Command: npx skills add https://github.com/MassimilianoPili/claude-code-config --skill systemd-services

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the management and understanding of systemd user-level services, which are crucial for running host processes like Node.js applications, Go binaries, and terminal emulators alongside Docker containers. It addresses challenges with PATH configuration, NVM integration, service dependencies, and logging.

Core Features & Use Cases

  • Service Management: Create, debug, and manage systemd user services for applications not running in Docker.
  • Configuration Guidance: Provides examples and best practices for ttyd.service, dashboard-api.service (Node.js), and claude-proxy.service (Go).
  • Troubleshooting: Offers solutions for common issues like PATH problems, NVM integration, and service startup failures.
  • Use Case: You need to run a Node.js dashboard API and a TTYD terminal on your server, but you want them to start automatically on login and be managed by systemd. This Skill provides the exact configurations and commands to achieve this.

Quick Start

Use the systemd-services skill to restart the dashboard-api service.

Frequently Asked Questions about systemd-services

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

FAQPage Schema
How do I configure a systemd user service for a Node.js application?

To configure a systemd user service for a Node.js application, you must address NVM integration by ensuring proper PATH configuration and loading environment variables via EnvironmentFile. This guarantees the service starts correctly on login.

Why does my systemd service fail to start due to PATH problems?

Systemd services fail due to PATH problems because the service environment lacks the user's shell profile, missing NVM paths. You must explicitly configure PATH and use EnvironmentFile to ensure Node.js or Go binaries are found at startup.

What is the best way to manage host processes alongside Docker containers?

The best way to manage host processes alongside Docker is using systemd user-level services. This approach clarifies host vs. Docker service division, allowing you to run applications like Go binaries and ttyd directly on the host with journalctl logging.

Can I use systemd to automatically start a ttyd terminal on login?

Yes, you can use systemd user-level services to automatically start a ttyd terminal on login. This Skill provides exact configuration patterns and dependencies needed to manage ttyd service alongside other host processes.

How do I debug systemd user service startup issues with journalctl?

Debug systemd user service startup issues by checking journalctl logs to identify configuration errors. This Skill offers troubleshooting patterns for common failures, specifically addressing NVM PATH challenges and missing environment variables.

Does systemd user service management work with Go binaries?

Yes, systemd user service management works with Go binaries by defining them in service files like claude-proxy.service. You ensure proper execution by configuring service dependencies and loading environment variables through EnvironmentFile.