docker-containers.nvim

A Neovim plugin for managing Docker containers, images, volumes, and networks directly from your editor

Preview

2026-06-29_10-33-01.mp4

Features

• Container Management: Start, stop, and restart Docker containers
• Multi-Resource View: Browse containers, images, volumes, and networks
• Docker Compose Support: Automatically groups containers by compose project
• Async Operations: Non-blocking container operations

Requirements

• Neovim 0.12 or higher
• Docker

Installation

Using lazy.nvim

{
  "HyperAfnan/docker-containers.nvim",
  dependencies = {
    "akinsho/toggleterm.nvim"
  },
  config = function()
    require("docker-containers").setup()
  end
}

Using packer.nvim

use {
  'HyperAfnan/docker-containers.nvim',
  requires = { 'akinsho/toggleterm.nvim' },
  config = function()
    require("docker-containers").setup()
  end
}

Using vim-plug

Plug 'HyperAfnan/docker-containers.nvim'
Plug 'akinsho/toggleterm.nvim'

Then in your init.lua:

require("docker-containers").setup()

Usage

:DockerContainers

Configuration

require("docker-containers").setup({
  position = "right",  -- left | right
  term = {
      direction = "horizontal" -- tabs | horizontal | vertical | float
  },
  maps = {
    collapse = "<space>",
    restart = "r",
    down = "d",
    start = "s",
    close = "q",
    help = "?",
  },
  icons = {
    container_running = "",
    container_stopped = "",
    project = "",
    expanded = "",
    collapsed = "",
  }
})

Acknowledgments

• Terminal integration via toggleterm.nvim