zeabur-startup-order

Diagnoses and fixes service startup order issues in Zeabur.

40|9|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/zeabur/zeabur-claude-plugin --skill zeabur-startup-order
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zeabur-startup-order
Source: https://github.com/zeabur/zeabur-claude-plugin/tree/main/skills/zeabur-startup-order
Command: npx skills add https://github.com/zeabur/zeabur-claude-plugin --skill zeabur-startup-order

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves "Connection refused" errors that occur when a service starts before its dependency (like a database or Redis) is ready to accept connections.

Core Features & Use Cases

  • Diagnose Startup Order Issues: Identifies when services fail due to dependencies not being fully initialized.
  • Implement Health Checks: Guides users to add healthCheck configurations to dependency services, ensuring they are ready before dependent services start.
  • Alternative Wait Loops: Provides a method to add a wait loop directly within the service's command if healthCheck cannot be configured.
  • Quick Restart: Offers a command to restart a service after a fix has been applied.
  • Use Case: Your API service is crashing with "Connection refused" errors when trying to connect to PostgreSQL. This Skill helps you configure Zeabur to wait for PostgreSQL to be fully ready before starting your API.

Quick Start

Use the zeabur-startup-order skill to restart the failed service with ID 'service-abc-123'.

Frequently Asked Questions about zeabur-startup-order

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

FAQPage Schema
Why does my service get a connection refused error when starting up?

A connection refused error occurs during startup when a service attempts to connect to a dependency like a database or Redis before that dependency is fully initialized and ready to accept connections.

How do I fix database connection refused errors caused by startup order?

To fix startup order connection refused errors, you can implement health check configurations on dependency services or add a command-line wait loop to ensure dependencies are ready before the dependent service launches.

What is a health check for service startup dependencies?

A health check for startup dependencies is a configuration applied to services like databases to verify their readiness, ensuring dependent services only launch after the dependency is fully initialized and accepting connections.

Can I use a wait loop instead of a health check to resolve service startup issues?

Yes, you can use a command-line wait loop as an alternative method to resolve service startup issues when health check configurations cannot be applied directly to the dependency service.

How do I restart a service after applying a startup order fix?

You can restart a service after applying a startup order fix by using the provided quick restart command with the specific service ID to relaunch the dependent service successfully.