Skip to content
Open
Changes from all commits
Commits
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
36 changes: 36 additions & 0 deletions motoko/hello_world/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,42 @@ If you modify the backend's public API, regenerate the `.did` file using the Mot
```bash
$(mops toolchain bin moc) --idl -o backend/backend.did backend/app.mo
```
## Troubleshooting

### `icp network start` exits with status 101

The error message is:
Error: network launcher ... exited prematurely with status exit status: 101

The real cause is hidden in the log file at:
.icp/cache/networks/local/network-launcher/stderr.log

Always check that file first:
```bash
cat .icp/cache/networks/local/network-launcher/stderr.log
```
#### Cause: port 8000 already in use

The most common cause is another process (e.g. a Docker container) already bound to port 8000:
Failed to bind to address 127.0.0.1:8000: Address already in use (os error 98)

**Fix:**
```bash
# Find what's using port 8000
sudo lsof -i :8000
# or
sudo ss -tlnp | grep 8000

Then kill it:
bash# Replace <PID> with the number from the output above
sudo kill -9 <PID>

Or do it in one shot:
bashsudo fuser -k 8000/tcp

# Then retry
icp network start -d
```

## Security considerations and best practices

Expand Down
Loading