refactor: rename code-server-linuxserver to code-server-lsio and set naming rules for compose names

This commit is contained in:
tiennm99 committed 2026-10-06 08:58:11 +07:00
1 parent a7137fcdc4
commit 18935e01a7
6 files changed
+20 -6

No files matched your search

+17 -3
View File
@@ -9,6 +9,20 @@ gitignored `.env`.
Every service uses `compose.yml` — the current Compose spec name, and the
shorter one. Not `docker-compose.yml`.
## Names
A service directory is named after the software it runs. When two services
package the same software, the one that is not upstream's own image takes a
suffix naming its source — `code-server-lsio` for LinuxServer's code-server —
so both can coexist. The suffix is a directory name only, forced by the
conflict; it is not a name to copy anywhere else.
Inside `compose.yml`, service, volume and network names follow the upstream
project's official Docker guide. Where the guide gives none, the main service
takes the image's own name (`code-server`, not `code-server-lsio`), and a
supporting container may be named for its role instead — `db`, `database`,
`cache` and the like.
## Installing software in an image
Follow the upstream project's own documented install method, or the one the
@@ -91,7 +105,7 @@ directory, one mounted at `/workspace`. The home volume holds settings,
credentials and CLI logins; `/workspace` holds the code. Point whatever
variable selects the working directory at `/workspace`.
`code-server-linuxserver`, `paseo` and `webtop` all follow this. A service with no
`code-server-lsio`, `paseo` and `webtop` all follow this. A service with no
human inside it does not — an agent such as `hermes` or `openclaw` keeps the
volume layout of its official Docker guide.
@@ -101,7 +115,7 @@ your extensions and logins.
Check who owns `/workspace` on a fresh volume. Docker creates it `root:root`
unless the image ships the directory, and an image that drops to a non-root
user will not be able to write there. `code-server-linuxserver` and `webtop` need an
user will not be able to write there. `code-server-lsio` and `webtop` need an
explicit `chown` for this reason; `paseo` does not.
## Environment variable order
@@ -187,7 +201,7 @@ Compose interpolation reads the deploying shell's environment before the
`.env` file, so a variable must not share a name with anything the shell
already exports. `HOSTNAME` is the trap: it is set inside every container,
including the one Coolify itself runs in, and would silently win. Hence
`SERVICE_HOSTNAME` in `code-server-linuxserver` and `paseo`.
`SERVICE_HOSTNAME` in `code-server-lsio` and `paseo`.
## Upstream sources
+1 -1
View File
@@ -77,7 +77,7 @@ Each links to its own README for variables, ports, and storage.
| Service | What it is |
| --- | --- |
| [alloy](alloy/README.md) | Grafana Alloy shipping host and Docker telemetry to Grafana Cloud |
| [code-server-linuxserver](code-server-linuxserver/README.md) | VS Code in the browser from the LinuxServer image, as a remote dev box |
| [code-server-lsio](code-server-lsio/README.md) | VS Code in the browser from the LinuxServer image, as a remote dev box |
| [couchbase](couchbase/README.md) | Couchbase Server |
| [diun](diun/README.md) | Image-update notifier, reading the Docker API through a read-only proxy |
| [gitea](gitea/README.md) | Gitea backed by PostgreSQL |
@@ -14,7 +14,7 @@ GIT_EMAIL=
# Container hostname, also passed in as HOST -- the name zsh's prompt shows.
# Not named HOSTNAME: the deploying shell's own HOSTNAME would override it.
SERVICE_HOSTNAME=code-server-linuxserver
SERVICE_HOSTNAME=code-server-lsio
# Name of the installed web app.
# PWA_APPNAME=code-server
File renamed without changes.
@@ -1,4 +1,4 @@
# code-server-linuxserver
# code-server-lsio
[VS Code in the browser](https://github.com/linuxserver/docker-code-server),
from the LinuxServer image, set up as a full remote dev box.
File renamed without changes.