zeabur-migration

Diagnose Zeabur services stuck waiting for database migrations and provide resolution steps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill resolves issues where services are stuck in a "Waiting for database migrations to complete" state, often occurring when an application expects a separate migration service that is not configured.

Core Features & Use Cases

  • Diagnose Migration Failures: Identifies services stuck in a perpetual migration wait state.
  • Provide Solutions: Offers two distinct methods to resolve the issue: integrating migrations into the API startup command or creating a dedicated migrator service.
  • Use Case: Your web application is deployed but shows a "Waiting for database migrations to complete..." message indefinitely. This Skill helps you fix it by either modifying your API's startup command or setting up a separate migration service.

Quick Start

Use the zeabur-migration skill to fix services stuck on waiting for database migrations.

Frequently Asked Questions about zeabur-migration

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

FAQPage Schema
Why does my Zeabur deployment get stuck waiting for database migrations to complete?

Your Zeabur deployment gets stuck waiting for database migrations because the application expects a separate migration service that is not configured. It remains in a perpetual wait state until you integrate migrations into the API startup command or set up a dedicated migrator service.

How do I fix a Zeabur service stuck on database migrations?

To fix a Zeabur service stuck on database migrations, you can either modify the API service's startup command to include migration execution or configure a separate dedicated migrator service. Both methods resolve the indefinite wait state.

Should I run database migrations on API startup or use a separate migrator service in Zeabur?

Running database migrations on API startup is simpler for smaller applications, while configuring a separate migrator service in Zeabur is better when your app expects migrations to run independently. Your choice depends on your deployment architecture.

Does this solution work for Docker deployments on Zeabur?

Yes, this solution works for Docker deployments on Zeabur experiencing deployment troubleshooting issues. It diagnoses services stuck in a perpetual migration wait state and provides solutions by modifying the API command or configuring a separate migrator service.

What to do when Zeabur database migration is not working?

When Zeabur database migration is not working, you should diagnose if the service is stuck in a perpetual migration wait state. Resolve it by modifying the API service's command to include migration execution on startup or by configuring a separate migrator service.