Skip to content

refactor(scripts): use dfx --system-canisters instead of manual NNS setup #630

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aterga merged 8 commits into from
Apr 24, 2026
Merged

refactor(scripts): use dfx --system-canisters instead of manual NNS setup #630

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
822c620
refactor(scripts): use dfx start --system-canisters instead of manual…
aterga Apr 8, 2026
ba2cf4d
fix: restore wasm fields in dfx.json for custom canister definitions
aterga Apr 8, 2026
40bf7dd
chore: regenerate TypeScript declarations with dfx 0.30.2
aterga Apr 9, 2026
c562b49
fix: impersonate governance canister for CMC set_authorized_subnetwor…
aterga Apr 9, 2026
d776485
fix: use --impersonate flag and upgrade icx-asset for dfx 0.30.2
aterga Apr 13, 2026
d2bd528
fix: re-deploy pinned II version over system-canisters bootstrap
aterga Apr 14, 2026
36c33cf
fix: use reinstall mode for II canister to replace system-bootstrappe…
aterga Apr 14, 2026
08cd238
fix: address PR review feedback for setup_system_canisters_post
aterga Apr 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 3 additions & 13 deletions .github/workflows/tests.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -166,10 +166,6 @@ jobs:
uses: dfinity/setup-dfx@main
- name: 'Setup Node'
uses: ./.github/actions/setup-node
- name: 'Install cbor2'
run: pip install cbor2
- name: 'Install crc32'
run: sudo apt install -y libarchive-zip-perl
- name: 'Install Dependencies'
run: |
pnpm install --frozen-lockfile
Expand All @@ -192,7 +188,7 @@ jobs:
- name: 'Install dfx'
uses: dfinity/setup-dfx@main
- name: 'Start PocketIC'
run: dfx start --clean --pocketic --host 127.0.0.1:4943 --background
run: dfx start --clean --system-canisters --host 127.0.0.1:4943 --background
- name: 'Perform local deployment'
run: ./orbit --init
- name: 'Test local deployment'
Expand All @@ -204,20 +200,14 @@ jobs:
steps:
- name: 'Checkout'
uses: actions/checkout@v4
- name: 'Setup Python'
uses: actions/setup-python@v5
- name: 'Install cbor2'
run: pip install cbor2
- name: 'Install crc32'
run: sudo apt install -y libarchive-zip-perl
- name: 'Setup Node'
uses: ./.github/actions/setup-node
- name: 'Run sccache-cache'
uses: mozilla-actions/sccache-action@v0.0.8
- name: 'Install dfx'
uses: dfinity/setup-dfx@main
- name: 'Start local replica'
run: dfx start --clean --host 127.0.0.1:4943 --background
run: dfx start --clean --system-canisters --host 127.0.0.1:4943 --background
- name: 'Perform local deployment'
run: ./orbit --init
- name: 'Test local deployment'
Expand Down Expand Up @@ -245,7 +235,7 @@ jobs:
- name: 'Install dfx'
uses: dfinity/setup-dfx@main
- name: 'Start local replica'
run: dfx start --clean --pocketic --host 127.0.0.1:4943 --background
run: dfx start --clean --system-canisters --host 127.0.0.1:4943 --background
- name: 'Test prod deployment script'
run: |
echo y | ./scripts/deploy.sh --local # install
Expand Down
12 changes: 2 additions & 10 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,22 +89,14 @@ Please make sure you have the following installed:

### Building the Code

Start a local replica listening on port 4943:
Start PocketIC with system canisters (ICP ledger, ICP index, CMC, Internet Identity) listening on port 4943:

```
dfx start --clean --pocketic --host 127.0.0.1:4943
dfx start --clean --system-canisters --host 127.0.0.1:4943
```

Note that the local replica should be stopped using `dfx stop` rather than by CTRL^C.
Comment thread
aterga marked this conversation as resolved.
Outdated

If you want to resume your local replica after `dfx stop`, then you need to install the Python package `cbor2`,
have the binary `crc32` to compute CRC32 checksums on your executable path,
and use the following command for the first time:

```
dfx start --clean --host 127.0.0.1:4943
```

Then the following steps can be used to setup the Orbit canister ecosystem for local development.

```bash
Expand Down
Loading
Loading