https://github.com/hatlabs/cockpit-dockermanager-debian
Debian packaging for Cockpit Docker Manager plugin
https://github.com/hatlabs/cockpit-dockermanager-debian
apt-package cockpit-project debian-package halos
Last synced: 5 months ago
JSON representation
Debian packaging for Cockpit Docker Manager plugin
- Host: GitHub
- URL: https://github.com/hatlabs/cockpit-dockermanager-debian
- Owner: hatlabs
- License: mit
- Created: 2025-11-04T14:32:07.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-02-05T09:12:53.000Z (5 months ago)
- Last Synced: 2026-02-05T21:19:06.170Z (5 months ago)
- Topics: apt-package, cockpit-project, debian-package, halos
- Language: Shell
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cockpit Docker Manager - Debian Packaging
This repository contains Debian packaging files for [cockpit-dockermanager](https://github.com/chrisjbawden/cockpit-dockermanager).
## Overview
Cockpit Docker Manager is a lightweight Cockpit plugin for managing Docker containers through a web interface.
## Building the Package
### Quick Start
Using the provided `run` script (recommended):
```bash
# Clone the packaging repository
git clone https://github.com/hatlabs/cockpit-dockermanager-debian.git
cd cockpit-dockermanager-debian
# Clone upstream source
./run setup:clone
# Build package in Docker (no local dependencies needed)
./run package:deb:docker
```
The package will be created as `cockpit-dockermanager_*.deb` in the current directory.
### Available Commands
Run `./run help` to see all available commands:
#### Setup Commands
- `./run setup:clone` - Clone upstream cockpit-dockermanager repository
- `./run setup:pull` - Update upstream repository
- `./run setup:checkout ` - Checkout specific upstream version
#### Build Commands
- `./run package:deb:docker` - Build using Docker (recommended, works on any platform)
- `./run package:deb` - Build locally (requires Debian/Ubuntu with build tools)
- `./run package:docker:build` - Build/rebuild the Docker tools image
#### Core Commands
- `./run release:version` - Show current package version
- `./run help` - Show all available commands
### Building with a Specific Version
To build a specific upstream version:
```bash
./run setup:checkout v1.0.7 # or any other tag (with 'v' prefix)
echo "1.0.7" > VERSION # Update package version (without 'v' prefix)
./run package:deb:docker
```
### Manual Build (without Docker)
If you prefer to build manually on Debian/Ubuntu:
```bash
# Install build dependencies
sudo apt-get install debhelper devscripts git
# Clone upstream source
git clone https://github.com/chrisjbawden/cockpit-dockermanager.git
# Build
dpkg-buildpackage -us -uc -b
```
## Installation
```bash
sudo dpkg -i cockpit-dockermanager_*.deb
sudo apt-get install -f # Install any missing dependencies
```
After installation, access Cockpit at `https://your-host:9090` and find "Docker Manager" in the sidebar.
## Package Structure
- `debian/control` - Package metadata, dependencies, and debhelper compatibility level
- `debian/rules` - Build instructions
- `debian/changelog` - Version history
- `debian/copyright` - License information (machine-readable format)
- `debian/install` - File installation mappings
- `debian/source/format` - Source package format (3.0 quilt)
- `docker/` - Docker build environment for cross-platform builds
- `run` - Build automation script
- `VERSION` - Package version tracking
## Dependencies
- `cockpit` (>= 200)
- `docker.io` or `docker-ce` (recommended)
## License
The packaging files are licensed under MIT License. See [LICENSE](LICENSE) file or `debian/copyright` for full details.
The upstream software is copyright © 2025 Chris Bawden and is also MIT licensed.
## Maintainer
Matti Airas
Hat Labs