SSH access

Connect directly to your environment containers using the Cloud CLI. The session runs through the aws CLI, so it must be installed on your machine.

Prerequisites

• AWS CLI must be installed — installation guide
• SSH must be enabled for the environment in the dashboard

Connect to a container

qc ssh

This opens an interactive bash shell in your environment container. If multiple containers are available, you’ll be prompted to select one.

Options

Flag	Description
--container <name>	Connect to a specific container (skip selection prompt)
--command <cmd>	Run a command instead of opening an interactive shell
--interactive	Force interactive mode when used with --command
--org <org>	Override organization
--app <app>	Override application
--env <env>	Override environment

Examples

Interactive shell

# Default: opens bash in the container
qc ssh

# Open a shell in a specific container
qc ssh --container=php

Run a one-shot command

# Check PHP version
qc ssh --command="php -v"

# Run a database migration
qc ssh --container=php --command="php artisan migrate"

# Check disk usage
qc ssh --command="df -h"

Interactive command

Use --interactive with --command when you need an interactive shell other than bash:

# Open an interactive sh shell
qc ssh --container=php --command="/bin/sh" --interactive

Override context

Connect to a specific environment without changing your active context:

qc ssh --org=my-org --app=my-app --env=production

Connection details

When a connection is established, the CLI displays:

• Cluster — the cluster that runs the environment
• Container — the container you’re connected to
• Region — the region the environment runs in
• Expires — when the session credentials expire
• Context — the org/app/env you’re connected to

See also

• qc ssh — full command reference.
• Enabling SSH access — dashboard configuration.
• qc env — manage the environments you SSH into.