-
-
Notifications
You must be signed in to change notification settings - Fork 321
Create mod to include bat in code-server #1073
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
aptalca
merged 6 commits into
linuxserver:code-server-bat
from
somewatson:code-server-bat
Dec 1, 2025
Merged
Changes from 2 commits
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
1729859
Create mod to include bat in code-server
somewatson 5662ddd
Address comments
somewatson 37838d6
Symlink bat-extras every time the install step is run
somewatson 8b5f478
Remove BRANCH from BuildImage.yml
somewatson 190ffd3
Update install
somewatson 759dee2
Add exception for git pull
somewatson 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
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -2,7 +2,7 @@ | |
|
|
||
| FROM scratch | ||
|
|
||
| LABEL maintainer="username" | ||
| LABEL maintainer="somewatson" | ||
|
|
||
| # copy local files | ||
| COPY root/ / | ||
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,25 +1,17 @@ | ||
| # Rsync - Docker mod for openssh-server | ||
| # Bat - Docker mod for code-server | ||
|
|
||
| This mod adds rsync to openssh-server, to be installed/updated during container start. | ||
| This mod adds [bat](https://github.com/sharkdp/bat) to code-server, to be installed/updated during container start. | ||
|
|
||
| In openssh-server docker arguments, set an environment variable `DOCKER_MODS=linuxserver/mods:openssh-server-rsync` | ||
| Bat is a cat(1) clone with syntax highlighting and Git integration. | ||
|
|
||
| If adding multiple mods, enter them in an array separated by `|`, such as `DOCKER_MODS=linuxserver/mods:openssh-server-rsync|linuxserver/mods:openssh-server-mod2` | ||
| In code-server docker arguments, set an environment variable `DOCKER_MODS=linuxserver/mods:code-server-bat` | ||
|
|
||
| # Mod creation instructions | ||
| If adding multiple mods, enter them in an array separated by `|`, such as `DOCKER_MODS=linuxserver/mods:code-server-bat|linuxserver/mods:openssh-server-mod2` | ||
|
|
||
| * Fork the repo, create a new branch based on the branch `template`. | ||
| * Edit the `Dockerfile` for the mod. `Dockerfile.complex` is only an example and included for reference; it should be deleted when done. | ||
| * Inspect the `root` folder contents. Edit, add and remove as necessary. | ||
| * After all init scripts and services are created, run `find ./ -path "./.git" -prune -o \( -name "run" -o -name "finish" -o -name "check" \) -not -perm -u=x,g=x,o=x -print -exec chmod +x {} +` to fix permissions. | ||
| * Edit this readme with pertinent info, delete these instructions. | ||
| * Finally edit the `.github/workflows/BuildImage.yml`. Customize the vars for `BASEIMAGE` and `MODNAME`. Set the versioning logic and `MULTI_ARCH` if needed. | ||
| * Ask the team to create a new branch named `<baseimagename>-<modname>`. Baseimage should be the name of the image the mod will be applied to. The new branch will be based on the `template` branch. | ||
| * Submit PR against the branch created by the team. | ||
| ### Bat-extras and Ripgrep | ||
|
|
||
| This mod also includes [bat-extras](https://github.com/eth-p/bat-extras) which has a dependency of [ripgrep](https://github.com/BurntSushi/ripgrep). Ripgrep has also been included because it is a requirment of bat-extras. | ||
|
|
||
| ## Tips and tricks | ||
| ### Aliases | ||
|
|
||
| * Some images have helpers built in, these images are currently: | ||
| * [Openvscode-server](https://github.com/linuxserver/docker-openvscode-server/pull/10/files) | ||
| * [Code-server](https://github.com/linuxserver/docker-code-server/pull/95) | ||
| This mod includes aliases for `bat` in `bash` and `zsh`. Under Ubuntu `bat` gets installed as `batcat` to avoid a name collision. So, for convenience, an alias to set `bat="batcat"` is included for both `bash` and `zsh`. |
File renamed without changes.
27 changes: 27 additions & 0 deletions
27
root/etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-add-package/run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| #!/usr/bin/with-contenv bash | ||
|
|
||
| # This is the init file used for adding os or pip packages to install lists. | ||
| # It takes advantage of the built-in init-mods-package-install init script that comes with the baseimages. | ||
| # If using this, we need to make sure we set this init as a dependency of init-mods-package-install so this one runs first | ||
| #!/usr/bin/with-contenv bash | ||
|
|
||
| if ! dpkg -s ripgrep >/dev/null 2>&1; then | ||
| echo "**** Adding ripgrep to package install list ****" | ||
| echo "ripgrep" >> /mod-repo-packages-to-install.list | ||
| else | ||
| echo "**** ripgrep already installed, skipping ****" | ||
| fi | ||
|
|
||
| if ! dpkg -s bat >/dev/null 2>&1; then | ||
| echo "**** Adding bat to package install list ****" | ||
| echo "bat" >> /mod-repo-packages-to-install.list | ||
| else | ||
| echo "**** bat already installed, skipping ****" | ||
| fi | ||
|
|
||
| if ! dpkg -s git >/dev/null 2>&1; then | ||
| echo "**** Adding git to package install list ****" | ||
| echo "git" >> /mod-repo-packages-to-install.list | ||
| else | ||
| echo "**** git already installed, skipping ****" | ||
| fi |
File renamed without changes.
1 change: 1 addition & 0 deletions
1
root/etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-add-package/up
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| /etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-add-package/run |
File renamed without changes.
57 changes: 57 additions & 0 deletions
57
root/etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-install/run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,57 @@ | ||
| #!/usr/bin/with-contenv bash | ||
|
|
||
| # This is an install script that is designed to run after init-mods-package-install | ||
| # so it can take advantage of packages installed | ||
| # init-mods-end depends on this script so that later init and services wait until this script exits | ||
|
|
||
| if ! command -v zsh >/dev/null 2>&1; then | ||
| echo "**** zsh not installed, skipping alias setup ****" | ||
| else | ||
| if [ -f ~/.zshrc ]; then | ||
|
aptalca marked this conversation as resolved.
Outdated
|
||
| if ! grep -q 'alias bat="batcat"' ~/.zshrc; then | ||
| echo 'Adding alias to zsh for bat' | ||
| echo 'alias bat="batcat"' >> ~/.zshrc | ||
| else | ||
| echo 'Alias already exists in zsh, skipping' | ||
| fi | ||
| else | ||
| echo '~/.zshrc not found, creating one with the alias' | ||
| echo 'alias bat="batcat"' > ~/.zshrc | ||
| fi | ||
| fi | ||
|
|
||
| if ! command -v bash >/dev/null 2>&1; then | ||
| echo "**** bash not installed, skipping alias setup ****" | ||
| else | ||
| if [ -f ~/.bash_profile ]; then | ||
| if ! grep -q 'alias bat="batcat"' ~/.bash_profile; then | ||
| echo 'Adding alias to ~/.bash_profile for bat' | ||
| echo 'alias bat="batcat"' >> ~/.bash_profile | ||
| else | ||
| echo 'Alias already exists in ~/.bash_profile, skipping' | ||
| fi | ||
| elif [ -f ~/.bashrc ]; then | ||
| if ! grep -q 'alias bat="batcat"' ~/.bashrc; then | ||
| echo 'Adding alias to ~/.bashrc for bat' | ||
| echo 'alias bat="batcat"' >> ~/.bashrc | ||
| else | ||
| echo 'Alias already exists in ~/.bashrc, skipping' | ||
| fi | ||
| else | ||
| echo '~/.bash_profile or ~/.bashrc not found, creating one with the alias' | ||
| echo 'alias bat="batcat"' > ~/.bash_profile | ||
| fi | ||
| fi | ||
|
|
||
| if [ -d ~/.bat-extras ]; then | ||
| echo 'Bat-extras already installed, skipping' | ||
| else | ||
| echo 'Installing bat-extras' | ||
| git clone https://github.com/eth-p/bat-extras.git ~/.bat-extras | ||
|
aptalca marked this conversation as resolved.
Outdated
|
||
| cd ~/.bat-extras/src | ||
| chmod +x ~/.bat-extras/src/*.sh | ||
| ln -s ~/.bat-extras/src/*.sh /usr/local/bin | ||
| fi | ||
|
|
||
| lsiown -R abc:abc \ | ||
| /config/.bat-extras | ||
File renamed without changes.
1 change: 1 addition & 0 deletions
1
root/etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-install/up
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| /etc/s6-overlay/s6-rc.d/init-mod-code-server-bat-install/run |
30 changes: 0 additions & 30 deletions
30
root/etc/s6-overlay/s6-rc.d/init-mod-imagename-modname-add-package/run
This file was deleted.
Oops, something went wrong.
1 change: 0 additions & 1 deletion
1
root/etc/s6-overlay/s6-rc.d/init-mod-imagename-modname-add-package/up
This file was deleted.
Oops, something went wrong.
8 changes: 0 additions & 8 deletions
8
root/etc/s6-overlay/s6-rc.d/init-mod-imagename-modname-install/run
This file was deleted.
Oops, something went wrong.
1 change: 0 additions & 1 deletion
1
root/etc/s6-overlay/s6-rc.d/init-mod-imagename-modname-install/up
This file was deleted.
Oops, something went wrong.
File renamed without changes.
File renamed without changes.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
File renamed without changes.
File renamed without changes.
Empty file.
Empty file.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.