Skip to content

Commit fecb99b

Browse files
committed
Update to Isaac Lab 2.3 image and remove root user
1 parent b9552f7 commit fecb99b

File tree

20 files changed

+242
-251
lines changed

20 files changed

+242
-251
lines changed

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,14 @@ The project includes:
1919
- Isaac Sim pre-installed
2020
- an Omniverse Kit App Streaming client, based on the [web-viewer-sample](https://github.com/NVIDIA-Omniverse/web-viewer-sample) project.
2121

22+
23+
2224
## Quickstart Guide
2325
This guide will get you started with a Visual Studio Code instance with Isaac Lab preinstalled, and an in-browser user interface provided by Kit App Streaming.
2426

27+
> [!IMPORTANT]
28+
> This project is intended for learning purposes. It is not intended for production use.
29+
2530
> [!NOTE]
2631
> Please note that Brev instances are pay-by-the hour. To make the best use of credits, stop instances when they are not in use. Stopped instances have a smaller storage charge.
2732
@@ -33,6 +38,7 @@ This guide will get you started with a Visual Studio Code instance with Isaac La
3338
4. On the Brev instance page, scroll to the TCP/UDP ports section.
3439
5. Click the link for port 80 (HTTP) to open Visual Studio Code Server.
3540
6. The default password is `password`. This can be modified.
41+
- To change the password, modify the `PASSWORD` environment variable in this [docker-compose.yml](https://github.com/isaac-sim/isaac-launchable/blob/main/isaac-lab/docker-compose.yml) file.
3642
7. Inside Visual Studio Code, continue with the [README.md](https://github.com/isaac-sim/isaac-launchable/blob/main/isaac-lab/vscode/README.md) instructions. A summary is provided below.
3743
8. Now you're in the Visual Studio Code dev environment!
3844

@@ -122,7 +128,7 @@ docker compose up -d
122128
7. Click Next.
123129
8. Under "Do you want a Jupyter Notebook experience" select "No, I don't want Jupyter".
124130
9. Select the TCP/UDP ports tab.
125-
10. Expose the following ports (for Visual Studio Code Server and Kit App Streaming). You can choose to limit these ports to be accessible only from certain IPs as well.
131+
10. Expose the following ports (for Visual Studio Code Server and Kit App Streaming) to a specific public IP address that will be using this service.
126132
```
127133
80
128134
1024
@@ -134,7 +140,7 @@ docker compose up -d
134140

135141
> [!NOTE]
136142
> GPUs with RT cores are required for Kit App Streaming.
137-
> The compute specs and driver versions provided also need to be compatible with [Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/5.0.0/installation/requirements.html). The available drivers are not exposed on this Brev page currently.
143+
> The compute specs and driver versions provided also need to be compatible with [Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/latest/installation/requirements.html). The available drivers are not exposed on this Brev page currently.
138144
139145
> [!IMPORTANT]
140146
> The project is not currently compatible with Crusoe instances. AWS has been tested and is used for the example launchable.
@@ -147,7 +153,7 @@ Congratulations! You now have a custom launchable.
147153

148154
This project can also be used to run a containerized version of Isaac Sim and Isaac Lab.
149155

150-
To use this project locally, you'll need a workstation that meets [Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/5.0.0/installation/requirements.html)'s requirements.
156+
To use this project locally, you'll need a workstation that meets [Isaac Sim](https://docs.isaacsim.omniverse.nvidia.com/latest/installation/requirements.html)'s requirements.
151157

152158

153159
1. Install the NVIDIA Container Toolkit: `sudo install nvidia-container-toolkit`

isaac-lab/docker-compose.yml

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,8 @@ services:
2626
network_mode: "host"
2727
runtime: nvidia
2828
volumes:
29-
- 'shared:/kube'
30-
- '/var/run/docker.sock:/var/run/docker.sock'
31-
- "ov-cache:/home/root/.cache/ov:rw"
32-
- "ov-local-share:/home/root/.local/share/ov/:rw"
33-
privileged: true
29+
- "ov-cache:/home/isaac-sim/.cache/ov:rw"
30+
- "ov-local-share:/home/isaac-sim/.local/share/ov/:rw"
3431
environment:
3532
- CUDA_VISIBLE_DEVICES=0
3633
- NVIDIA_VISIBLE_DEVICES=all

isaac-lab/vscode/Dockerfile

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,7 @@
1212
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1313
# See the License for the specific language governing permissions and
1414
# limitations under the License.
15-
FROM nvcr.io/nvidia/isaac-lab:2.2.0
16-
17-
USER root
18-
ENV OMNI_KIT_ALLOW_ROOT=1
15+
FROM nvcr.io/nvidia/isaac-lab:2.3.0
1916

2017
RUN apt update && \
2118
apt install -y \
@@ -35,8 +32,9 @@ RUN apt update && \
3532

3633
ENV WORKSPACE_DIR=/workspace
3734

38-
COPY --chown=ubuntu:ubuntu ./README.md ${WORKSPACE_DIR}/README.md
39-
COPY --chown=ubuntu:ubuntu ./settings.json ${WORKSPACE_DIR}/.vscode/settings.json
35+
COPY --chown=isaac-sim:isaac-sim ./README.md ${WORKSPACE_DIR}/README.md
36+
COPY --chown=isaac-sim:isaac-sim ./settings.json ${WORKSPACE_DIR}/.vscode/settings.json
37+
4038

4139
RUN code-server \
4240
--install-extension ms-python.python \
@@ -46,11 +44,17 @@ RUN code-server \
4644
COPY entrypoint.sh /entrypoint.sh
4745

4846
# OV Cache Directories
49-
RUN mkdir -p /home/root/.cache/ov
50-
RUN mkdir -p /home/root/.local/share/ov
51-
RUN chown root:root /home/root/.cache/ov
52-
RUN chown root:root /home/root/.local/share/ov
47+
RUN mkdir -p /home/isaac-sim/.cache/ov
48+
RUN mkdir -p /home/isaac-sim/.local/share/ov
49+
50+
# Fix permissions for ubuntu user
51+
RUN chown -R isaac-sim /workspace /home/isaac-sim/.cache/ov /home/isaac-sim/.local/share/ov /isaac-sim/kit/cache
52+
53+
# Copy bashrc to get aliases
54+
RUN cp /root/.bashrc /isaac-sim/.root-bashrc
55+
RUN echo 'source $HOME/.root-bashrc' >> /isaac-sim/.bashrc
5356

57+
USER isaac-sim:isaac-sim
5458

5559
ENTRYPOINT ["/bin/bash"]
5660

isaac-lab/vscode/README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,30 @@
33
This project provides a simple way to interact with Isaac Lab, and Isaac Sim, either on the cloud or locally.
44
See the [project repo](https://github.com/isaac-sim/isaac-launchable) for more detaild instructions, but below is a quickstart guide.
55

6-
## Running Isaac Lab
6+
## Running Isaac Lab 2.3
77

88
You can run any of the Issac Lab scripts with the streaming Isaac Sim experience with the following command:
99

1010
```console
11-
./isaaclab/isaaclab.sh -p "isaaclab/scripts/tutorials/00_sim/create_empty.py" --kit_args="--no-window --enable omni.kit.livestream.webrtc"
11+
cd /workspace/isaaclab
12+
./isaaclab.sh -p scripts/tutorials/00_sim/create_empty.py --livestream 2
1213
```
1314

1415
Then, in a separate browser window, open `http://{your instance's address}/viewer`.
1516

16-
To run any other Isaac Lab commands, simply append those same arguments as shown above: `--kit_args="--no-window --enable omni.kit.livestream.webrtc"`
17+
To run any other Isaac Lab commands, simply append the same argument as shown above: `--livestream 2`
1718

18-
## Running Isaac Sim
19+
## Running Isaac Sim 5.1
1920

20-
You can run the streaming Isaac Sim application at anytime with the following command:
21+
You can run the streaming Isaac Sim application at anytime with the following command.
2122

2223
```console
23-
./isaaclab/_isaac_sim/isaac-sim.sh --no-window --enable omni.kit.livestream.webrtc
24+
/isaac-sim/runheadless.sh
25+
```
26+
27+
Or to run and simultaneously accept the EULA:
28+
```console
29+
ACCEPT_EULA=y /isaac-sim/runheadless.sh
2430
```
2531

2632
Then, in a separate browser window, open `https://{your instance's address}/viewer`.

0 commit comments

Comments
 (0)