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: installation.mdx
+24-29Lines changed: 24 additions & 29 deletions
Original file line number
Diff line number
Diff line change
@@ -29,16 +29,6 @@ icon: "terminal"
29
29
npm i -g mint
30
30
```
31
31
32
-
33
-
```bash yarn
34
-
yarn global add mint
35
-
```
36
-
37
-
38
-
```bash pnpm
39
-
pnpm add -g mint
40
-
```
41
-
42
32
</CodeGroup>
43
33
</Step>
44
34
<Steptitle="Preview locally.">
@@ -61,15 +51,6 @@ npx mint dev
61
51
```
62
52
63
53
64
-
```bash yarn
65
-
yarn dlx mint dev
66
-
```
67
-
68
-
69
-
```bash pnpm
70
-
pnpm dlx mint dev
71
-
```
72
-
73
54
</CodeGroup>
74
55
75
56
## Updates
@@ -89,15 +70,6 @@ npm i -g mint@latest
89
70
```
90
71
91
72
92
-
```bash yarn
93
-
yarn global upgrade mint
94
-
```
95
-
96
-
97
-
```bash pnpm
98
-
pnpm up --global mint
99
-
```
100
-
101
73
</CodeGroup>
102
74
103
75
## Custom ports
@@ -158,11 +130,34 @@ If you use JetBrains, we recommend the [MDX IntelliJ IDEA plugin](https://plugin
158
130
<Accordiontitle='Error: Could not load the "sharp" module using the darwin-arm64 runtime'>
159
131
This may be due to an outdated version of node. Try the following:
160
132
161
-
1. Remove the currently-installed version of the mint CLI: `npm remove -g mint`
133
+
1. Remove the currently-installed version of the mint CLI: `npm uninstall -g mint`
162
134
2. Upgrade to Node.js.
163
135
3. Reinstall the mint CLI: `npm install -g mint`
164
136
</Accordion>
165
137
<Accordiontitle="Issue: Encountering an unknown error">
166
138
Solution: Go to the root of your device and delete the `~/.mintlify` folder. Afterwards, run `mint dev` again.
167
139
</Accordion>
140
+
<Accordiontitle="Error: permission denied">
141
+
This is due to not having the required permissions to globally install node packages.
142
+
Solution: Try running `sudo npm i -g mint`. You will be prompted for your password, which is the one you use to unlock your computer.
143
+
</Accordion>
144
+
<Accordiontitle="The local preview doesn't look the same as my docs do on the web">
145
+
Likely this is due to an outdated version of the CLI.
146
+
Solution: Run `mint update` to get the latest changes.
147
+
</Accordion>
148
+
<Accordiontitle="mintlify vs. mint package">
149
+
When having any problems with the CLI package, the first thing we'll ask you to do when troubleshooting is paste the output of `npm ls -g`, which shows what packages are globally installed on your machine. You may see that you have a package named "mint" and a package named "mintlify" installed. It will be less confusing to have only one of them installed.
0 commit comments