Skip to main content
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

FlagDescriptionDefault
-s, --serviceService type: mysql, postgresql, redisRequired
-w, --waitWait until service is runningfalse
--timeoutMax 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.
FlagDescriptionDefault
-s, --serviceService type to removeRequired
-f, --forceSkip confirmation promptfalse
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

ServiceFlag ValuePortVersion
MySQLmysql33068.0
PostgreSQLpostgresql543214
Redisredis63797
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.