qc ssh

Open an interactive SSH session into a container in the active environment. Built on top of AWS ECS Exec. Use it to debug a running container, run management commands, or inspect filesystem state.

For a full walkthrough including AWS CLI prerequisites and SSH-over-key patterns, see the SSH access guide.

Synopsis

qc ssh [options]

Description

By default qc ssh opens an interactive Bash shell in the active environment. If the environment runs a single container, it connects directly; if it runs several, you’re prompted to choose one (or pass --container to skip the prompt). Pass --command to run a one-shot command instead of opening an interactive shell.

Options

Flag	Description	Default
--container <name>	Specific container to connect to.	Auto-connects if only one; prompts if several.
--org <org>	Organization machine name.	Active organization.
--app <app>	Application machine name.	Active application.
--env <env>	Environment name.	Active environment.
--command <cmd>	Command to run inside the container.	/bin/bash
--interactive	Force interactive mode when used with --command.	—
--platform <platform>	Override the active platform.	—

Examples

Open an interactive shell

qc ssh

Connect to a specific container

qc ssh --container worker

Run a one-shot command

qc ssh --command "drush cache:rebuild"

Force interactive mode with a custom shell

qc ssh --command /bin/zsh --interactive

Connect to a specific environment

qc ssh --env staging --container web

See also

• SSH access guide — AWS prerequisites and best practices.
• qc env — manage environments.