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
<p>If you run into an error during deployment, try the following:</p>
249
249
<ol>
250
-
<li>Ensure that you have followed the instructions correctly in <ahref="./installation.html">the installation chapter</a>, especially noting <ahref="./installation.html#common-installation-issues">the common installation issues</a></li>
251
-
<li>Look for more error output by adding the <code>--verbose</code> flag to the <code>build</code> command in your <code>dfx.json</code> file like so: <code>"build": "python -m kybra canister_name src/main.py src/main.did --verbose</code></li>
252
-
<li>Look for errors in each of the files in <code>~/.config/kybra/[kybra_version]/logs</code></li>
253
-
<li>If the problem is still not resolved, reach out with any error outputs in <ahref="https://discord.gg/ux2Jc7psjd">the Discord channel</a></li>
250
+
<li>
251
+
<p>Ensure that you have followed the instructions correctly in <ahref="./installation.html">the installation chapter</a>, especially noting <ahref="./installation.html#common-installation-issues">the common installation issues</a></p>
252
+
</li>
253
+
<li>
254
+
<p>Ensure that you have created and activated your virtual environment, and that you have done the following from within that virtual environment: installed Kybra, installed the Kybra dfx extension, and run <code>dfx deploy</code>:</p>
<p>Look for more error output by adding the <code>KYBRA_VERBOSE=true</code> environment variable to <code>dfx deploy</code> like so: <code>KYBRA_VERBOSE=true dfx deploy</code></p>
264
+
</li>
265
+
<li>
266
+
<p>Look for errors in each of the files in <code>~/.config/kybra/[kybra_version]/logs</code></p>
267
+
</li>
268
+
<li>
269
+
<p>If the problem is still not resolved, reach out with any error outputs in <ahref="https://discord.gg/ux2Jc7psjd">the Discord channel</a></p>
<p>Now install Kybra and the Kybra dfx extension:</p>
174
174
<pre><codeclass="language-bash">pip install kybra
175
+
python -m kybra install-dfx-extension
175
176
</code></pre>
176
177
<p>Open up <code>kybra_hello_world</code> in your text editor (we recommend <ahref="https://code.visualstudio.com/">VS Code</a> with the <ahref="https://marketplace.visualstudio.com/items?itemName=ms-python.python">Microsoft Python extension</a>).</p>
<p>You should be using a *nix environment (Linux, Mac OS, <ahref="https://learn.microsoft.com/en-us/windows/wsl/install">WSL if using Windows</a>) with bash and have the following installed on your system:</p>
<p>Run the following command to install dfx 0.19.0:</p>
170
-
<pre><codeclass="language-bash">DFX_VERSION=0.19.0 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
169
+
<p>Run the following command to install dfx 0.23.0:</p>
170
+
<pre><codeclass="language-bash">DFX_VERSION=0.23.0 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
171
171
</code></pre>
172
172
<p>If after trying to run <code>dfx</code> commands you encounter an error such as <code>dfx: command not found</code>, you might need to add <code>$HOME/bin</code> to your path. Here's an example of doing this in your <code>.bashrc</code>:</p>
<p>You should be using a *nix environment (Linux, Mac OS, <ahref="https://learn.microsoft.com/en-us/windows/wsl/install">WSL if using Windows</a>) with bash and have the following installed on your system:</p>
<p>Run the following command to install dfx 0.19.0:</p>
358
-
<pre><codeclass="language-bash">DFX_VERSION=0.19.0 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
357
+
<p>Run the following command to install dfx 0.23.0:</p>
358
+
<pre><codeclass="language-bash">DFX_VERSION=0.23.0 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
359
359
</code></pre>
360
360
<p>If after trying to run <code>dfx</code> commands you encounter an error such as <code>dfx: command not found</code>, you might need to add <code>$HOME/bin</code> to your path. Here's an example of doing this in your <code>.bashrc</code>:</p>
<p>Now install Kybra and the Kybra dfx extension:</p>
420
420
<pre><codeclass="language-bash">pip install kybra
421
+
python -m kybra install-dfx-extension
421
422
</code></pre>
422
423
<p>Open up <code>kybra_hello_world</code> in your text editor (we recommend <ahref="https://code.visualstudio.com/">VS Code</a> with the <ahref="https://marketplace.visualstudio.com/items?itemName=ms-python.python">Microsoft Python extension</a>).</p>
<p>If you run into an error during deployment, try the following:</p>
624
612
<ol>
625
-
<li>Ensure that you have followed the instructions correctly in <ahref="./installation.html">the installation chapter</a>, especially noting <ahref="./installation.html#common-installation-issues">the common installation issues</a></li>
626
-
<li>Look for more error output by adding the <code>--verbose</code> flag to the <code>build</code> command in your <code>dfx.json</code> file like so: <code>"build": "python -m kybra canister_name src/main.py src/main.did --verbose</code></li>
627
-
<li>Look for errors in each of the files in <code>~/.config/kybra/[kybra_version]/logs</code></li>
628
-
<li>If the problem is still not resolved, reach out with any error outputs in <ahref="https://discord.gg/ux2Jc7psjd">the Discord channel</a></li>
613
+
<li>
614
+
<p>Ensure that you have followed the instructions correctly in <ahref="./installation.html">the installation chapter</a>, especially noting <ahref="./installation.html#common-installation-issues">the common installation issues</a></p>
615
+
</li>
616
+
<li>
617
+
<p>Ensure that you have created and activated your virtual environment, and that you have done the following from within that virtual environment: installed Kybra, installed the Kybra dfx extension, and run <code>dfx deploy</code>:</p>
<p>Look for more error output by adding the <code>KYBRA_VERBOSE=true</code> environment variable to <code>dfx deploy</code> like so: <code>KYBRA_VERBOSE=true dfx deploy</code></p>
627
+
</li>
628
+
<li>
629
+
<p>Look for errors in each of the files in <code>~/.config/kybra/[kybra_version]/logs</code></p>
630
+
</li>
631
+
<li>
632
+
<p>If the problem is still not resolved, reach out with any error outputs in <ahref="https://discord.gg/ux2Jc7psjd">the Discord channel</a></p>
<p>Kybra has many example projects showing nearly all Kybra APIs. They can be found in the <ahref="https://github.com/demergent-labs/kybra/tree/main/examples">examples directory</a> of the <ahref="https://github.com/demergent-labs/kybra">Kybra GitHub repository</a>.</p>
Copy file name to clipboardExpand all lines: the_kybra_book/src/deployment.md
+13-3Lines changed: 13 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -160,6 +160,16 @@ If you have problems deploying see [Common deployment issues](./deployment.md#co
160
160
If you run into an error during deployment, try the following:
161
161
162
162
1. Ensure that you have followed the instructions correctly in [the installation chapter](./installation.md), especially noting [the common installation issues](./installation.md#common-installation-issues)
163
-
2. Look for more error output by adding the `--verbose` flag to the `build` command in your `dfx.json` file like so: `"build": "python -m kybra canister_name src/main.py src/main.did --verbose`
164
-
3. Look for errors in each of the files in `~/.config/kybra/[kybra_version]/logs`
165
-
4. If the problem is still not resolved, reach out with any error outputs in [the Discord channel](https://discord.gg/ux2Jc7psjd)
163
+
2. Ensure that you have created and activated your virtual environment, and that you have done the following from within that virtual environment: installed Kybra, installed the Kybra dfx extension, and run `dfx deploy`:
164
+
165
+
```bash
166
+
~/.pyenv/versions/3.10.7/bin/python -m venv venv
167
+
source venv/bin/activate
168
+
pip install kybra
169
+
python -m kybra install-dfx-extension
170
+
dfx deploy
171
+
```
172
+
173
+
3. Look for more error output by adding the `KYBRA_VERBOSE=true` environment variable to `dfx deploy` like so: `KYBRA_VERBOSE=true dfx deploy`
174
+
4. Look forerrorsin each of the files in`~/.config/kybra/[kybra_version]/logs`
175
+
5. If the problem is still not resolved, reach out with any error outputs in [the Discord channel](https://discord.gg/ux2Jc7psjd)
Copy file name to clipboardExpand all lines: the_kybra_book/src/hello_world.md
+4-16Lines changed: 4 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -34,10 +34,11 @@ Now create and source a virtual environment:
34
34
source venv/bin/activate
35
35
```
36
36
37
-
Now install Kybra:
37
+
Now install Kybra and the Kybra dfx extension:
38
38
39
39
```bash
40
40
pip install kybra
41
+
python -m kybra install-dfx-extension
41
42
```
42
43
43
44
Open up `kybra_hello_world` in your text editor (we recommend [VS Code](https://code.visualstudio.com/) with the [Microsoft Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python)).
@@ -112,21 +113,8 @@ Create the following in `kybra_hello_world/dfx.json`:
0 commit comments