https://github.com/dstmodders/docker-ktools
Dockerized modding tools by nsimplex for the Klei Entertainment's game Don't Starve.
https://github.com/dstmodders/docker-ktools
docker docker-image dont-starve dont-starve-together game hacktoberfest modding modding-tools
Last synced: 4 months ago
JSON representation
Dockerized modding tools by nsimplex for the Klei Entertainment's game Don't Starve.
- Host: GitHub
- URL: https://github.com/dstmodders/docker-ktools
- Owner: dstmodders
- License: mit
- Created: 2020-03-30T20:47:02.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-11-28T05:11:46.000Z (7 months ago)
- Last Synced: 2025-11-29T15:56:24.068Z (7 months ago)
- Topics: docker, docker-image, dont-starve, dont-starve-together, game, hacktoberfest, modding, modding-tools
- Language: Shell
- Homepage: https://hub.docker.com/r/dstmodders/ktools
- Size: 413 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-ktools
[![Debian Size]](https://hub.docker.com/r/dstmodders/ktools)
[![Alpine Size]](https://hub.docker.com/r/dstmodders/ktools)
[![CI]](https://github.com/dstmodders/docker-ktools/actions/workflows/ci.yml)
[![Build]](https://github.com/dstmodders/docker-ktools/actions/workflows/build.yml)
> [!NOTE]
> This repository uses a fork [dstmodders/ktools] instead of the original
> [nsimplex/ktools]. All tags prefixed with "official" point to
> [official releases]. See [fork releases] to learn more.
## Supported tags and respective `Dockerfile` links
- [`4.5.1-imagemagick-7.1.2-1-alpine`, `4.5.1-alpine`, `4.5.1`, `alpine`, `latest`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/alpine/Dockerfile)
- [`4.5.1-imagemagick-7.1.2-1-debian`, `4.5.1-debian`, `debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/debian/Dockerfile)
- [`4.5.0-imagemagick-7.1.2-1-alpine`, `4.5.0-alpine`, `4.5.0`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/alpine/Dockerfile)
- [`4.5.0-imagemagick-7.1.2-1-debian`, `4.5.0-debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/debian/Dockerfile)
- [`4.4.1-imagemagick-6.9.13-27-alpine`, `4.4.1-alpine`, `4.4.1`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/alpine/Dockerfile)
- [`4.4.1-imagemagick-6.9.13-27-debian`, `4.4.1-debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/latest/debian/Dockerfile)
- [`official-4.4.0-imagemagick-6.9.13-27-alpine`, `official-4.4.0-alpine`, `official-4.4.0`, `official-alpine`, `official-latest`, `official`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/alpine/Dockerfile)
- [`official-4.4.0-imagemagick-6.9.13-27-debian`, `official-4.4.0-debian`, `official-debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/debian/Dockerfile)
- [`official-4.3.1-imagemagick-6.9.13-27-alpine`, `official-4.3.1-alpine`, `official-4.3.1`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/alpine/Dockerfile)
- [`official-4.3.1-imagemagick-6.9.13-27-debian`, `official-4.3.1-debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/debian/Dockerfile)
- [`official-4.3.0-imagemagick-6.9.13-27-alpine`, `official-4.3.0-alpine`, `official-4.3.0`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/alpine/Dockerfile)
- [`official-4.3.0-imagemagick-6.9.13-27-debian`, `official-4.3.0-debian`](https://github.com/dstmodders/docker-ktools/blob/bbf86a76e934a55e865becfbf4581e558ca87f74/official/debian/Dockerfile)
## Overview
[Docker] images for modding tools of Klei Entertainment's game [Don't Starve].
- [Usage](#usage)
- [Supported environment variables](#supported-environment-variables)
- [Supported build arguments](#supported-build-arguments)
- [Supported architectures](#supported-architectures)
- [Build](#build)
## Usage
[Fork releases] (recommended):
```shell
$ docker pull dstmodders/ktools:latest
# or
$ docker pull ghcr.io/dstmodders/ktools:latest
```
Or you can pick one of the [official releases]:
```shell
$ docker pull dstmodders/ktools:official
# or
$ docker pull ghcr.io/dstmodders/ktools:official
```
See [tags] for a list of all available versions.
#### Shell/Bash (Linux & macOS)
```shell
$ docker run --rm -v "$(pwd):/data/" dstmodders/ktools ktech --version
```
#### CMD (Windows)
```cmd
> docker run --rm -v "%CD%:/data/" dstmodders/ktools ktech --version
```
#### PowerShell (Windows)
```powershell
PS:\> docker run --rm -v "${PWD}:/data/" dstmodders/ktools ktech --version
```
## Supported environment variables
| Name | Value | Description |
| --------------------- | ---------------------- | --------------------- |
| `IMAGEMAGICK_VERSION` | `7.1.2-1` | [ImageMagick] version |
| `KTOOLS_KRANE` | `/usr/local/bin/krane` | [ktools/krane] path |
| `KTOOLS_KTECH` | `/usr/local/bin/ktech` | [ktools/ktech] path |
| `KTOOLS_VERSION` | `4.5.1` | [ktools] version |
## Supported build arguments
| Name | Image | Default | Description |
| -------------------------- | ------------------------ | -------------------------- | ------------------------------------ |
| `IMAGEMAGICK_IMAGE_PREFIX` | `latest`
`official` | -
`legacy-` | Sets [ImageMagick] base image prefix |
| `IMAGEMAGICK_VERSION` | `latest`
`official` | `7.1.2-1`
`6.9.13-27` | Sets [ImageMagick] version |
| `KTOOLS_VERSION` | `latest`
`official` | `4.5.1`
`4.4.0` | Sets [ktools] version |
## Supported architectures
| Image | Architecture(s) |
| ---------- | -------------------------- |
| `latest` | `linux/amd64`, `linux/386` |
| `official` | `linux/amd64`, `linux/386` |
## Build
To build images locally:
```shell
$ docker build --tag='dstmodders/ktools:alpine' ./latest/alpine/
$ docker build --tag='dstmodders/ktools:debian' ./latest/debian/
$ docker build --tag='dstmodders/ktools:official-alpine' ./official/alpine/
$ docker build --tag='dstmodders/ktools:official-debian' ./official/debian/
```
Respectively, to build multi-platform images using [buildx]:
```shell
$ docker buildx build --platform='linux/amd64,linux/386' --tag='dstmodders/ktools:alpine' ./latest/alpine/
$ docker buildx build --platform='linux/amd64,linux/386' --tag='dstmodders/ktools:debian' ./latest/debian/
$ docker buildx build --platform='linux/amd64,linux/386' --tag='dstmodders/ktools:official-alpine' ./official/alpine/
$ docker buildx build --platform='linux/amd64,linux/386' --tag='dstmodders/ktools:official-debian' ./official/debian/
```
## License
Released under the [MIT License](https://opensource.org/licenses/MIT).
[alpine size]: https://img.shields.io/docker/image-size/dstmodders/ktools/alpine?label=alpine%20size&logo=docker
[build]: https://img.shields.io/github/actions/workflow/status/dstmodders/docker-ktools/build.yml?branch=main&label=build&logo=github
[buildx]: https://github.com/docker/buildx
[ci]: https://img.shields.io/github/actions/workflow/status/dstmodders/docker-ktools/ci.yml?branch=main&label=ci&logo=github
[debian size]: https://img.shields.io/docker/image-size/dstmodders/ktools/debian?label=debian%20size&logo=docker
[docker]: https://www.docker.com/
[don't starve]: https://www.klei.com/games/dont-starve
[dstmodders/ktools]: https://github.com/dstmodders/ktools
[fork releases]: https://github.com/dstmodders/ktools/releases
[imagemagick]: https://imagemagick.org/index.php
[ktools/krane]: https://github.com/dstmodders/ktools?tab=readme-ov-file#krane
[ktools/ktech]: https://github.com/dstmodders/ktools?tab=readme-ov-file#ktech
[ktools]: https://github.com/dstmodders/ktools
[nsimplex/ktools]: https://github.com/nsimplex/ktools
[official releases]: https://github.com/nsimplex/ktools/releases
[tags]: https://hub.docker.com/r/dstmodders/ktools/tags