Add TROUBLESHOOTING.md
This commit is contained in:
parent
f3d0da2075
commit
1b3933a9d2
|
@ -0,0 +1,31 @@
|
|||
# Troubleshooting
|
||||
|
||||
## Installation
|
||||
|
||||
### Compiler Issues
|
||||
Currently a number of ENiGMA½'s NPM dependencies include modules that require C bindings, and thus, may need compiled uf prebuilt binaries are not available on NPM for your system/architecture. This is often the case for older Linux systems, some ARM devices, etc.
|
||||
|
||||
**Example**: Compiling `sqlite3` from source with `npm`:
|
||||
```bash
|
||||
npm rebuild --build-from-source sqlite3
|
||||
```
|
||||
|
||||
With `yarn`:
|
||||
```bash
|
||||
env npm_config_build_from_source=true yarn install sqlite3
|
||||
```
|
||||
|
||||
If you get compiler errors when running `npm install` or `yarn`, you can try rebuilding with compiler overrides.
|
||||
|
||||
**Example**: Overriding compilers for `node-pty` compilation:
|
||||
|
||||
```bash
|
||||
env CC=gcc CXX=gcc npm rebuild --build-from-source node-pty
|
||||
```
|
||||
|
||||
## Upgrades
|
||||
|
||||
### Missing Menu & Theme Entries
|
||||
One thing to be sure and check after an update is your menu/prompt HJSON configurations as well as your theme(s). The default templates are updated alongside features, but you may need to merge in fragments missing from your own.
|
||||
|
||||
See also [Updating](./docs/admin/updating.md).
|
Loading…
Reference in New Issue