Manage database services installed inside your pods. Aliases: service, svc.
List Services
instapods services list my-app
Shows all installed services with their status, type, port, and version. Failed services display their error message inline.
Install a Service
instapods services add my-app -s mysql
instapods services add my-app -s postgresql
instapods services add my-app -s redis
Alias: services install.
Wait for Installation
Service installation runs in the background (typically 8-15 seconds). Use -w to block until ready:
instapods services add my-app -s mysql -w
If installation fails, the -w flag shows the actual error reason instead of just “failed”.
Install Flags
| Flag | Description | Default |
|---|
-s, --service | Service type: mysql, postgresql, redis | Required |
-w, --wait | Wait until service is running | false |
--timeout | Max seconds to wait (with -w) | 120 |
# Install with extended timeout
instapods services add my-app -s postgresql -w --timeout 180
Remove a Service
# With confirmation prompt
instapods services remove my-app -s mysql
# Skip confirmation
instapods services remove my-app -s mysql -f
Aliases: rm, delete, uninstall.
| Flag | Description | Default |
|---|
-s, --service | Service type to remove | Required |
-f, --force | Skip confirmation prompt | false |
Removing a service deletes all its data permanently. There is no undo.
Get Credentials
instapods services creds my-app -s mysql
Aliases: credentials, info.
Displays connection details and a ready-to-use connection command:
Host: localhost
Port: 3306
Username: instapod
Password: (auto-generated)
Database: instapod
Connect: mysql -u instapod -p<password> instapod
Connection commands vary by service:
- MySQL:
mysql -u instapod -p<password> instapod
- PostgreSQL:
PGPASSWORD=<password> psql -U instapod -d instapod
- Redis:
redis-cli
Available Services
| Service | Flag Value | Port | Version |
|---|
| MySQL | mysql | 3306 | 8.0 |
| PostgreSQL | postgresql | 5432 | 14 |
| Redis | redis | 6379 | 7 |
Services require the Build plan or higher. Launch plan pods cannot install services. Upgrade your pod’s plan with instapods pods resize my-app --plan build to enable services.
See the Services section for detailed usage guides for each database.