Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
cd99956
feat: add comprehensive login page customization options
strickvl Jun 12, 2025
bac8b42
Merge branch 'main' into main
strickvl Jun 17, 2025
2553f45
feat: replace individual UI flags with unified --custom-strings flag
strickvl Jun 17, 2025
c2eb61d
docs: simplify migration guide to only cover released flags
strickvl Jun 17, 2025
c0189ed
docs: update Docker customization examples to use --custom-strings
strickvl Jun 17, 2025
cacf3cc
Merge branch 'main' into main
strickvl Jun 21, 2025
2b2819e
docs: remove niche customization sections from FAQ and install guide
strickvl Jun 24, 2025
b275d52
refactor: remove redundant custom-strings validation and global variable
strickvl Jun 24, 2025
af2f599
refactor: simplify loadCustomStrings function signature and error han…
strickvl Jun 24, 2025
e89a9af
test: remove outdated tests for deprecated custom UI flags
strickvl Jun 24, 2025
a8b7fbe
refactor: use addResourceBundle instead of re-initializing i18next
strickvl Jun 24, 2025
27ee714
docs: improve custom-strings flag description
strickvl Jun 24, 2025
d5c0c88
refactor: keep --app-name flag as non-deprecated for {{app}} placeholder
strickvl Jun 24, 2025
fd6ca51
refactor: rename --custom-strings flag to --i18n
strickvl Jun 24, 2025
ca12a25
docs: consolidate i18n documentation in guide.md
strickvl Jun 24, 2025
dceb0a6
refactor: simplify --i18n flag to file-only approach
strickvl Jun 24, 2025
9bf53dc
CI fixes
strickvl Jun 27, 2025
354677c
Merge branch 'main' into main
strickvl Jun 27, 2025
0d4bd15
Address test coverage
strickvl Jun 27, 2025
File filter

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs: update Docker customization examples to use --custom-strings
Replace outdated CS_* environment variable examples with the new
--custom-strings flag approach. Include both inline JSON and
mounted file examples for Docker users.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
  • Loading branch information
strickvl and claude committed Jun 17, 2025
commit c0189ed3faa9e05e18cb9dd792d5f6a41d10b7a0
34 changes: 19 additions & 15 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -289,27 +289,31 @@ docker run -it --name code-server -p 127.0.0.1:8080:8080 \

### Customizing the login page

You can customize the login page by setting environment variables:
You can customize the login page using the `--custom-strings` flag:

```bash
# Example with login customization
# Example with inline JSON customization
docker run -it --name code-server -p 127.0.0.1:8080:8080 \
-v "$PWD:/home/coder/project" \
-e "CS_LOGIN_TITLE=My Development Environment" \
-e "CS_LOGIN_ENV_PASSWORD_MSG=Password configured via environment variable" \
-e "CS_PASSWORD_PLACEHOLDER=Enter your secure password" \
-e "CS_SUBMIT_TEXT=ACCESS" \
codercom/code-server:latest
codercom/code-server:latest --custom-strings '{
"LOGIN_TITLE": "My Development Environment",
"WELCOME": "Welcome to your coding workspace",
"PASSWORD_PLACEHOLDER": "Enter your secure password",
"SUBMIT": "ACCESS"
}'
```

Or mount a JSON file:

```bash
# Example with JSON file
docker run -it --name code-server -p 127.0.0.1:8080:8080 \
-v "$PWD:/home/coder/project" \
-v "$PWD/custom-strings.json:/config/strings.json" \
codercom/code-server:latest --custom-strings /config/strings.json
```

Available customization environment variables:
- `CS_LOGIN_TITLE` - Custom login page title
- `CS_LOGIN_BELOW` - Custom text below the login title
- `CS_PASSWORD_PLACEHOLDER` - Custom password field placeholder
- `CS_SUBMIT_TEXT` - Custom submit button text
- `CS_LOGIN_PASSWORD_MSG` - Custom message for config file password
- `CS_LOGIN_ENV_PASSWORD_MSG` - Custom message when using `$PASSWORD` env var
- `CS_LOGIN_HASHED_PASSWORD_MSG` - Custom message when using `$HASHED_PASSWORD` env var
For detailed customization options, see the [customization guide](./customization.md).

Our official image supports `amd64` and `arm64`. For `arm32` support, you can
use a [community-maintained code-server
Expand Down