You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 30, 2023. It is now read-only.
Copy file name to clipboardExpand all lines: script-library/docs/desktop-lite.md
+37-9Lines changed: 37 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,6 +54,22 @@ You can use this script for your primary dev container by adding it to the `feat
54
54
55
55
If you have already built your development container, run the **Rebuild Container** command from the command palette (<kbd>Ctrl/Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>F1</kbd>) to pick up the change.
56
56
57
+
If you run into applications crashing, you may need to increase the size of the shared memory space. For example, this will bump it up to 1 GB in `devcontainer.json`:
58
+
59
+
```json
60
+
runArgs: ["--shm-size=1g"]
61
+
```
62
+
63
+
Or using Docker Compose:
64
+
65
+
```yaml
66
+
services:
67
+
your-service-here:
68
+
# ...
69
+
shm_size: '1gb'
70
+
# ...
71
+
```
72
+
57
73
### Script use
58
74
59
75
1. Add [`desktop-lite-debian.sh`](../desktop-lite-debian.sh) to `.devcontainer/library-scripts`
@@ -95,9 +111,26 @@ If you have already built your development container, run the **Rebuild Containe
95
111
96
112
The `runArgs` / Docker Compose setting allows the container to take advantage of an [init process](https://docs.docker.com/engine/reference/run/#specify-an-init-process) to handle application and process signals in a desktop environment.
97
113
98
-
4. Once you've started the container / codespace, you'll be able to use a browser on port **6080** from anywhere or connect a [VNC viewer](https://www.realvnc.com/en/connect/download/viewer/) to port **5901** when accessing the codespace from VS Code.
114
+
4. If you run into applications crashing, you may need to increase the size of the shared memory space. For example, this will bump it up to 1 GB in `devcontainer.json`:
115
+
116
+
```json
117
+
runArgs: ["--init", "--shm-size=1g"]
118
+
```
119
+
120
+
Or using Docker Compose:
121
+
122
+
```yaml
123
+
services:
124
+
your-service-here:
125
+
# ...
126
+
init: true
127
+
shm_size: '1gb'
128
+
# ...
129
+
```
99
130
100
-
5. Default **password**: `vscode`
131
+
5. Once you've started the container / codespace, you'll be able to use a browser on port **6080** from anywhere or connect a [VNC viewer](https://www.realvnc.com/en/connect/download/viewer/) to port **5901** when accessing the codespace from VS Code.
132
+
133
+
6. Default **password**: `vscode`
101
134
102
135
The window manager is installed is [Fluxbox](http://fluxbox.org/). **Right-click** to see the application menu. In addition, any UI-based commands you execute in the VS Code integrated terminal will automatically appear on the desktop.
103
136
@@ -122,14 +155,9 @@ If you want the full version of **Google Chrome** in the desktop:
122
155
```Dockerfile
123
156
RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
&& if type zsh > /dev/null 2>&1; then echo "${ALIASES}" >> /etc/zsh/zshrc; fi
158
+
&& apt-get -y install /tmp/chrome.deb
129
159
```
130
160
131
-
2. Chrome sandbox support requires you set up and run as a non-root user. The [`debian-common.sh`](common.md) script can do this for you, or you [set one up yourself](https://aka.ms/vscode-remote/containers/non-root). Alternatively, you can start Chrome using `google-chrome --no-sandbox --disable-dev-shm-usage`
132
-
133
-
3. While Chrome should be aliased correctly with the instructions above, if you run into crashes, pass `--disable-dev-shm-usage` in as an argument when starting it: `google-chrome --disable-dev-shm-usage`
161
+
2. Chrome sandbox support requires you set up and run as a non-root user. The [`debian-common.sh`](common.md) script can do this for you, or you [set one up yourself](https://aka.ms/vscode-remote/containers/non-root). Alternatively, you can start Chrome using `google-chrome --no-sandbox`
0 commit comments