Troubleshooting - ish-app/ish GitHub Wiki
Troubleshooting potential errors
Stuff happens, and things do go wrong. Here are some common troubleshooting tips for building and while running the app. If this page couldn't resolve any issues you were facing, you're very welcome to ask for help in our Discord server, in a GitHub issue, or by other contact methods found on the website.
Building
You can build iSH by making sure to have installed the dependencies and following further setup instructions in the Readme.
Building iSH for iOS requires macOS, as is to be expected. When building iSH, make sure to follow the instructions in the Readme, and that you have installed the extra dependencies for iOS building.
Running
Issues with networking/apk
If you've received an error when installing a program or running apk update
, e.g.
fetch http://dl-cdn.alpinelinux.org/alpine/v3.8/main/x86/APKINDEX.tar.gz
ERROR: http://dl-cdn.alpinelinux.org/alpine/v3.8/main: temporary error (try again later)
Check the output of cat /etc/resolv.conf
.
If that returns nothing, you might be connected to a cellular network. Solutions to this:
- Connect to a WiFi network so iSH can get the nameservers automatically, or
- Set your own nameservers:
$ echo "nameserver 8.8.8.8" > /etc/resolv.conf
Now try it again!
Issues on running commands such as bash or neofetch
Sometimes you will receive an error error relocating ... symbol not found
when running bash or any installed tool. This is because musl
and other alpine packages need to be upgraded. A simple apk upgrade -a
will fix it.