imoize/ubuntu-s6 repository overview

⁠Ubuntu-s6 Docker Image

Custom image based on ubuntu with s6-overlay.

⁠Supported Architectures

Multi-platform available trough docker manifest. More information is available from docker here⁠.

Simply pulling using latest tag should retrieve the correct image for your arch.

The architectures supported by this image:

⁠Usage

Here are some example to help you get started creating a container, easiest way to setup is using docker-compose or use docker cli.

• docker-compose (recommended)

---
version: "3.9"
services:
  ubuntu:
    image: imoize/ubuntu-s6:latest
    container_name: ubuntu
    environment:
      - PUID=1001
      - PGID=1001
      - TZ=Asia/Jakarta
    restart: always

• docker cli

docker run -d \
  --name=ubuntu \
  -e PUID=1001 \
  -e PGID=1001 \
  -e TZ=Asia/Jakarta \
  --restart always \
  imoize/ubuntu-s6:latest

⁠Available environment variables:

⁠Configuration

⁠Environment variables

When you start the ubuntu-s6 image, you can adjust the configuration of the instance by passing one or more environment variables either on the docker-compose file or on the docker run command line. Please note that some variables are only considered when the container is started for the first time. If you want to add a new environment variable:

• for docker-compose add the variable name and value:

ubuntu-s6:
    ...
    environment:
    - PUID=1001
    ...

• for manual execution add a -e option with each variable and value:

  docker run -d \
  -e PUID=1001 \
  imoize/ubuntu-s6:latest

⁠User / Group Identifiers

For example: PUID=1001 and PGID=1001, to find yours user id and gid type id <your_username> in terminal.

  $ id your_username
    uid=1001(user) gid=1001(group) groups=1001(group)

⁠Tips / Info

• Shell access whilst the container is running:

docker exec -it ubuntu /bin/bash

• To monitor the logs of the container in realtime:

docker logs -f ubuntu

• Container version number:

docker inspect -f '{{ index .Config.Labels "build_version" }}' ubuntu

• Image version number:

docker inspect -f '{{ index .Config.Labels "build_version" }}' imoize/ubuntu-s6:latest

⁠Upgrade this image

We recommend that you follow these steps to upgrade your container.

⁠Step 1: Get the updated image

docker pull imoize/ubuntu-s6:latest

or if you're using Docker Compose, update the value of the image property to imoize/ubuntu-s6:latest.

⁠Step 2: Stop currently running container

Stop the currently running container using this command.

docker stop ubuntu

or using Docker Compose:

docker-compose stop ubuntu

⁠Step 3: Remove currently running container

Remove the currently running container using this command.

docker rm -v ubuntu

or using Docker Compose:

docker-compose rm -v ubuntu

⁠Step 4: Run the new image

Re-create your container from the new image.

docker run --name ubuntu imoize/ubuntu-s6:latest

or using Docker Compose:

docker-compose up -d ubuntu

⁠Step 5: Remove the old dangling images

You can also remove the old dangling images.

docker image prune

⁠Contributing

We'd love for you to contribute to this container. You can submitting a pull request⁠ with your contribution.

⁠Issues

If you encountered a problem running this container, you can create an issue⁠.