Back to docs index

Docker Integration

Termial integrates with Docker, letting you manage containers directly from the sidebar without switching to another terminal.

Requirements

  • Docker must be installed on your system
  • Docker daemon must be running
  • Termial needs to know where Docker is installed

Configuration

Setting Up Docker

  1. Go to Settings → Docker
  2. Choose how to find Docker:
    • Auto-detect: Termial searches common installation paths
    • Custom path: Specify the exact path to the Docker executable
  3. Click Test Docker Connection to verify
  4. Click Save

Common Docker Paths

PlatformCommon Paths
macOS/usr/local/bin/docker, /opt/homebrew/bin/docker
Linux/usr/bin/docker, /usr/local/bin/docker
WindowsC:\Program Files\Docker\Docker\resources\bin\docker.exe

Container List

When Docker is configured, you'll see your containers in the sidebar:

  • Running containers - Currently active containers
  • Stopped containers - Containers that are not running

Click Refresh to update the list.

Container Management

Starting a Container

  1. Find a stopped container in the list
  2. Right-click and select Start
  3. The container starts and status updates

Stopping a Container

  1. Find a running container
  2. Right-click and select Stop
  3. The container stops gracefully

Restarting a Container

  1. Right-click a container
  2. Select Restart
  3. The container stops and starts again

Executing into Containers

Open a terminal session inside a container:

  1. Right-click a running container
  2. Select Exec or Open Shell
  3. A new terminal tab opens connected to the container
  4. Use the container's shell (bash, sh, etc.)

Termial automatically detects the best shell available in the container.

Container File Browser

Browse and manage files inside containers:

  1. Right-click a running container
  2. Select Browse Files
  3. Navigate the container's filesystem

File Operations

In the container file browser:

  • Download: Copy files from container to your computer
  • Upload: Copy files from your computer to the container
  • New Folder: Create directories inside the container
  • Delete: Remove files or folders from the container

Container Information

View container details:

  1. Click a container in the list
  2. See status, image, ports, and other details
  3. View when it was created and started

Troubleshooting

Docker Not Found

If Termial can't find Docker:

  1. Ensure Docker is installed
  2. Check that Docker daemon is running
  3. Try specifying the custom path manually
  4. Run which docker in terminal to find the path

Docker Not Running

If Docker is found but not connected:

  1. Start Docker Desktop (macOS/Windows) or the Docker service (Linux)
  2. Wait for Docker to fully start
  3. Click Refresh Detection in settings
  4. Test the connection again

Permission Issues

On Linux, you may need to add your user to the docker group:

sudo usermod -aG docker $USER

Then log out and back in.

Tips

  • Keep Docker Desktop running for best experience
  • Use container names that are easy to identify
  • Stop unused containers to free resources
  • Use the file browser for quick config edits