docker-cups

KO | EN

gitlite — search

#python #typescript #llm #android #machine-learning #deep-learning #docker #macos #nodejs #awesome #kubernetes #vue #pytorch #ios

(★ 38)

Creates an Alpine Linux CUPS server

docker-cups Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CUPS on Docker

[![Build Status](https://img.shields.io/docker/automated/thbe/cups.svg)](https://hub.docker.com/r/thbe/cups/builds/) [![GitHub Stars](https://img.shields.io/github/stars/thbe/docker-cups.svg)](https://github.com/thbe/docker-cups/stargazers) [![Docker Stars](https://img.shields.io/docker/stars/thbe/cups.svg)](https://hub.docker.com/r/thbe/cups) [![Docker Pulls](https://img.shields.io/docker/pulls/thbe/cups.svg)](https://hub.docker.com/r/thbe/cups)

This is a Docker image to run a CUPS instance with built in Apples zeroconf support.

This Docker image is based on the offical [Alpine](https://hub.docker.com/r/_/alpine/) image.

#### Table of Contents

- [Install Docker](https://github.com/thbe/docker-cups#install-docker)
- [Download](https://github.com/thbe/docker-cups#download)
- [How to use this image](https://github.com/thbe/docker-cups#how-to-use-this-image)
- [Next steps](https://github.com/thbe/docker-cups#next-steps)
- [Important notes](https://github.com/thbe/docker-cups#important-notes)
- [Update Docker image](https://github.com/thbe/docker-cups#update-docker-image)
- [Advanced usage](https://github.com/thbe/docker-cups#advanced-usage)
- [Technical details](https://github.com/thbe/docker-cups#technical-details)
- [Development](https://github.com/thbe/docker-cups#development)

## Install Docker

To use this image you have to [install Docker](https://docs.docker.com/engine/installation/) first.

## Download

You can get the trusted build from the [Docker Hub registry](https://hub.docker.com/r/thbe/cups/):

```
docker pull thbe/cups
```

Alternatively, you may build the Docker image from the
[source code](https://github.com/thbe/docker-cups#build-from-source-code) on GitHub.

## How to use this image

### Environment variables

You can use two environment variables that will be recognized by the start script.

#### `CUPS_PASSWORD`

If this environment variable is set, the string will be used as the password for the `root` user.

#### `CUPS_DEBUG`

If this environment variable is set, the scripts inside the container will run in debug mode.

### Start the CUPS instance

The instance can be started by the [start script](https://raw.githubusercontent.com/thbe/docker-cups/master/start_cups.sh)
from GitHub:

```
wget https://raw.githubusercontent.com/thbe/docker-cups/master/start_cups.sh
export CUPS_PASSWORD='SeCre!1'
chmod 755 start_cups.sh
./start_cups.sh
```

### Check server status

You can use the standard Docker commands to examine the status of the CUPS instance:

```
docker logs --tail 1000 --follow --timestamps cups
```

## Next steps

The next release of this Docker image should have a persistent CUPS configuration.

## Important notes

The username for the print server is `root`/`password` unless you don't change the password with the environment
variable as described in the [Environment variables](https://github.com/thbe/docker-cups#how-to-use-this-image)
section.

## Update Docker image

Simply download the trusted build from the [Docker Hub registry](https://hub.docker.com/r/thbe/cups/):

```
docker pull thbe/cups
```

## Advanced usage

### Build from source code

You can build the image also from source. To do this you have to clone the
[docker-cups](https://github.com/thbe/docker-cups) repository from GitHub:

```
git clone https://github.com/thbe/docker-cups.git
cd docker-cups
docker build --rm --no-cache -t thbe/cups .
```

### Bash shell inside container

If you need a shell inside the container you can run the following command:

```
docker exec -ti cups /bin/sh
```

### Add network tools ###

If you need network tools to debug your installation use the following command:

```
docker exec -ti cups /bin/sh
apk update
apk add iputils iproute2
```

## Technical details

- Alpine base image
- CUPS binary from official Alpine package repository

## Development

If you like to add functions or improve this Docker image, feel free to fork the repository and send me a merge request with the modification.

docker-cups

docker-cups Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

docker-cups

docker-cups Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README