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: docs/mac/installation.md
+33-15Lines changed: 33 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,13 +24,7 @@ Then use the CLI to install the Mac-specific binaries:
24
24
slicer install slicer-mac ~/slicer-mac
25
25
```
26
26
27
-
During preview, Slicer for Mac does not come with a background service/definition (known as a plist on macOS). So you need to launch it as and when you want it. Either directly in a terminal, or in a `tmux` window.
28
-
29
-
`tmux` is available via `brew install tmux`, and you can get [brew here](https://brew.sh).
30
-
31
-
The `slicer` command acts as an API client to Slicer for Mac.
32
-
33
-
By default, `slicer` auto-discovers the local mac socket at `~/slicer-mac/slicer.sock`, so you usually don't need any socket flags or environment variables for local use.
27
+
The `slicer` command acts as an API client to Slicer for Mac. It'll automatically discover the socket at `~/slicer-mac/slicer.sock`, so you won't need to set `--url` or `SLICER_URL`.
34
28
35
29
## Initial configuration.
36
30
@@ -40,12 +34,6 @@ First of all, get used to it, leave it in the path we recommend (`~/slicer-mac`)
40
34
41
35
The `slicer-mac` OCI bundle includes a default `slicer-mac.yaml` in the folder after install, so you can use that file directly.
42
36
43
-
Only run this if you want to recreate the file because you edited or edited it.
44
-
45
-
```bash
46
-
cd~/slicer-mac
47
-
./slicer-mac new > slicer-mac.yaml
48
-
```
49
37
50
38
The generated `slicer-mac.yaml` has two host groups:
51
39
@@ -88,6 +76,13 @@ Need Rosetta for x86_64 binaries? Follow [Enable Rosetta](/mac/rosetta).
88
76
89
77
Run the daemon. The first run pulls and prepares the VM image automatically.
90
78
79
+
If you ever need to regenerate the `slicer-mac.yaml` file, you can do so with the command below:
80
+
81
+
```bash
82
+
cd ~/slicer-mac
83
+
./slicer-mac new > slicer-mac.yaml
84
+
```
85
+
91
86
## Start the daemon
92
87
93
88
Start `slicer-mac`:
@@ -160,7 +155,9 @@ slicer vm exec sbox-1 -- stat ~/file.txt
160
155
slicer vm delete sbox-1
161
156
```
162
157
163
-
## Run slicer-mac as a background service
158
+
## Start Slicer for Mac with your system
159
+
160
+
If you'd like to enable Slicer for Mac as a start-up service, you can run the following:
164
161
165
162
```bash
166
163
cd ~/slicer-mac
@@ -172,7 +169,28 @@ cd ~/slicer-mac
172
169
./slicer-mac install
173
170
```
174
171
175
-
To uninstall:
172
+
Once running in the backgroud, you can use the `slicer-tray service` commands to manage it.
173
+
174
+
The `daemon` service is `slicer-mac` itself, and the `tray` service is the `slicer-tray` menu bar helper.
175
+
176
+
```bash
177
+
cd ~/slicer-mac
178
+
179
+
# Check the status of either service:
180
+
./slicer-mac service status daemon
181
+
./slicer-mac service status tray
182
+
183
+
# View the logs from the process - if you see an error or want to know
0 commit comments