Skip to content

Commit 8e3f15d

Browse files
committed
Add container branding page from blog
1 parent 1d68ecd commit 8e3f15d

5 files changed

Lines changed: 26 additions & 6 deletions

File tree

27.6 KB
Loading
21.4 KB
Loading
25.6 KB
Loading

docs/general/.pages

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
nav:
2-
- container-execution.md
32
- containers-101.md
4-
- running-our-containers.md
3+
- container-branding.md
54
- container-customization.md
5+
- container-execution.md
66
- docker-compose.md
7-
- understanding-puid-and-pgid.md
8-
- updating-our-containers.md
9-
- volumes.md
107
- fleet.md
11-
- swag.md
128
- how-to-get-support.md
9+
- running-our-containers.md
1310
- split-dns.md
11+
- swag.md
12+
- understanding-puid-and-pgid.md
13+
- updating-our-containers.md
14+
- volumes.md

docs/general/container-branding.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Container Branding
2+
3+
If you use our base images for your own projects, or fork our downstream images to modify them, you're probably aware that we ask you to change the branding that appears in the container init logs to make it clear that your image is not associated with us. This is for your benefit as much as ours: we aren't well-equipped to provide your users with support, and you don't want them crediting us for your work.
4+
5+
Iif you build from one of our base images and don't change anything, your init logs will look something like this:
6+
7+
![Default Container Branding](../assets/images/lsio-branding1.png)
8+
9+
If you want to add your own branding, when using our base images or a forked downstream one, just place a file called `branding` containing the text you want to use into the `/etc/s6-overlay/s6-rc.d/init-adduser` folder of your image. The branding file will replace the highlighted section of the init:
10+
11+
![Default Container Branding with Hightlights](../assets/images/lsio-branding2.png)
12+
13+
On start-up, the base image will automatically load the branding into its init, allowing you to inflict whatever ASCII art you like on your users:
14+
15+
![Custom Container Branding](../assets/images/lsio-branding2.png)
16+
17+
Hopefully this makes it simpler for everyone to manage the branding of your images when using our bases.
18+
19+
A final note: if you've previously overridden the `init-adduser` run file to do custom branding, we recommend switching to the above approach so that you don't miss out on any future changes to that init step.

0 commit comments

Comments
 (0)