Get Started

Cockpit Docker Manager is a simple, no-fuss Docker management UI for Cockpit.

  • Works on most Linux distros where Cockpit does (see official Cockpit resource).
  • Docker must be installed and running on the host.
  • User must be a member of the docker group for full access.

Installation

Manual

Show steps
  1. Download the latest .tar release from GitHub Releases .
  2. Extract contents to your Cockpit applications directory:

    sudo tar -xvf cockpit-dockermanager.tar.gz -C /usr/share/cockpit/
  3. If Cockpit is already open, refresh your browser.
Note: You may need to adjust the install path depending on your distro.

Ubuntu

Automatic (recommended)
  1. Add the APT repository
    2. echo "deb [trusted=yes] https://chrisjbawden.github.io/cockpit-dockermanager stable main" | sudo tee /etc/apt/sources.list.d/cockpit-dockermanager.list
  2. Update and install
    3. sudo apt update
    sudo apt install dockermanager
  3. If Cockpit is already open, refresh your browser.
Scripted
  1. Run the following in a terminal
    2. curl -L -o dockermanager.deb https://github.com/chrisjbawden/cockpit-dockermanager/releases/download/latest/dockermanager.deb && sudo dpkg -i dockermanager.deb && rm dockermanager.deb
  2. If Cockpit is already open, refresh your browser.

RHEL / Fedora

Automatic (recommended)
  1. Add the YUM repository
    2. sudo tee /etc/yum.repos.d/cockpit-dockermanager.repo <<'EOF'
        [cockpit-dockermanager]
        name=Cockpit Docker Manager
        baseurl=https://chrisjbawden.github.io/cockpit-dockermanager/yum/stable/
        enabled=1
        gpgcheck=0
        metadata_expire=0
        EOF
  2. Install the package
    3. sudo yum install dockermanager
  3. If Cockpit is already open, refresh your browser.
Scripted
  1. Run the following in a terminal
    2. curl -sSL https://raw.githubusercontent.com/chrisjbawden/cockpit-dockermanager/main/install-fedora.sh | bash
  2. If Cockpit is already open, refresh your browser.

Features

  • Start, stop, and restart Docker containers via the UI
  • View container logs
  • Access to host's and container terminal
  • CPU and RAM usage stats (auto-refresh every 15seconds)
  • Search containers by name
  • Sort containers by name or uptime

FAQ

  • Q: I can't see any containers or getting and error?
    A: Make sure your user is in the docker group, and that Docker is running.

  • Q: How do I handle systematic update?
    A: If you are using a manual install process, you could explore a cron solution, ie;

    curl -L -o dockermanager.deb https://github.com/chrisjbawden/cockpit-dockermanager/releases/download/latest/dockermanager.deb && sudo dpkg -i dockermanager.deb && rm dockermanager.deb


  • Q: How do I subscribe to the canary branch
    A: The first option is to use the github docs as a repo for your distro (apt install dockermanager-canary/yum install dockermanmager-canary). Alternatively you could use the manual install process but target the 'dockermanager-canary' packages. There should always be a dockermanager-canary latest if you want to target an automated solution outside of configuring a repository.

Issues & Support

Review and report issues or bugs via - GitHub Issues.

Contributing

  • Pull requests are welcome! Please target the canary branch for new features and testing.
  • Use discussions to suggest new features, or ask questions and issues to report bugs or issues
  • Subscribe to the canary branch and provide input on changes/development
  • Please follow the GitHub Flow.

Links

Cockpit Project
Project GitHub Repo