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
Copy file name to clipboardExpand all lines: README.md
+56-9Lines changed: 56 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -127,9 +127,64 @@ Note that the user doesn't have to download, install, or compile any R packages
127
127
128
128
### Stop using package sets
129
129
```sh
130
-
./icrn_manager kernels use none
130
+
./icrn_manager kernels use R none
131
131
```
132
132
133
+
## Web Interface
134
+
135
+
The ICRN Kernel Manager includes a web-based interface for browsing available kernels and searching for packages. The web interface provides an intuitive way to explore the kernel catalog without using the command line.
136
+
137
+
### Starting the Web Interface with Docker
138
+
139
+
The web interface runs in a Docker container. To start it:
140
+
141
+
1. **Build the Docker image:**
142
+
```sh
143
+
docker build -t icrn-web ./web
144
+
```
145
+
146
+
2. **Run the container:**
147
+
```sh
148
+
docker run -d -p 8080:80 --name icrn-web icrn-web
149
+
```
150
+
151
+
This starts the container in detached mode, mapping port 8080 on your host to port 80 in the container.
152
+
153
+
3. **Copy example data into the container (optional):**
154
+
155
+
If you have example data files (`collated_manifests.json` and `package_index.json`), you can copy them into the running container:
The web service will automatically detect and load these files.
162
+
163
+
4. **Access the web interface:**
164
+
165
+
Open your web browser and navigate to:
166
+
```
167
+
http://localhost:8080
168
+
```
169
+
170
+
### Web Interface Features
171
+
172
+
The web interface provides two main views:
173
+
174
+
- **View Kernels**: Browse available kernels organized by language, view kernel details, and see packages included in each kernel. You can filter and sort packages, and copy commands to get or use specific kernels.
175
+
176
+
- **View Packages**: Search for packages by name to see which kernels contain them. Results show the language, kernel name, kernel version, and package version for each match.
177
+
178
+
### Managing the Docker Container
179
+
180
+
- **Rebuild after making changes:**
181
+
```sh
182
+
docker stop icrn-web
183
+
docker rm icrn-web
184
+
docker build -t icrn-web ./web
185
+
docker run -d -p 8080:80 --name icrn-web icrn-web
186
+
```
187
+
133
188
## Implementation Details
134
189
135
190
### Testing
@@ -144,7 +199,6 @@ The project includes a comprehensive test suite to ensure reliability and code q
144
199
./tests/run_tests.sh update_r_libs # R library management
0 commit comments