Ganache is your personal blockchain for Ethereum development.
Please open issues and pull requests for new features, questions, and bug fixes.
To get started:
If using Windows, you may need windows-build-tools installed first.
Each platform has an associated
npm run configuration to help you build on each platform more easily. Because each platform has different (but similar) build processes, they require different configuration. Note that both Windows and Mac require certificates to sign the built packages; for security reasons these certs aren’t uploaded to github, nor are their passwords saved in source control.
Building on Windows will create a
.appx file for use with the Windows Store.
Before building, create the
./certs directory with the following files:
./certs/cert.pfx- Note a
.pfxfile is identical to a
.p12. (Just change the extension if you’ve been given a
In order to build on Windows, you must first ensure you have the Windows 10 SDK installed. If you have errors during the build process, ensure the package.json file’s
windowsStoreConfig.windowsKit points to your Windows 10 SDK directory. The one specified in the package.json file currently is what worked at the time this process was figured out; it may need to be updated periodically.
Because Windows requires a certificate to build the package – and that certificate requires a password – you’ll need to run the following command instead of
npm run make:
$ CERT_PASS="..." npm run build-windows
... in the command above with your certificate password.
This will create a
.appx file in
Building on a Mac will create a standard Mac
Before building on a Mac, make sure you have Truffle’s signing keys added to your keychain. Next, run the following command:
$ npm run build-mac
This will create a signed
.dmg file in
Bulding on Linux will create a
.AppImage file, meant to run on many versions of Linux.
Linux requires no signing keys, so there’s no set up. Simply run the following command:
$ npm run build-linux
This will create a
.AppImage file in
Asset generation generally only needs to happen once, or whenever the app’s logo is updated. If you find you need to rebuild the assets, the following applications were used:
Two tools were used:
electron-icon-maker generates assets for all platforms when using Electron’s
squirrel package, and these assets live in
svg2uwptiles generates all assets needed for the Windows appx build, and those assets live in
./resources/appx. These locations can be changed in the future, but make sure to change the associated configuration pointing to these assets.
Note from the author: I found managing these assets manually – especially the appx assets – was a pain. If possible, try not to edit the assets themselves and use one of the generators above.
Ganache is part of the Truffle suite of tools. Find out more!