Repository navigation
Installation
Download and install Kindling on your platform.
Get the latest release from the GitHub Releases page.
| Platform | File | Description |
|---|---|---|
| macOS | Kindling_<version>_universal.dmg |
One build for both Apple Silicon and Intel |
| Windows | Kindling_<version>_x64-setup.exe |
Windows installer (recommended) |
| Windows | Kindling_<version>_x64_en-US.msi |
MSI package, for managed or scripted installs |
| Linux | Kindling_<version>_amd64.AppImage |
Portable, works on most distros |
| Linux (Debian/Ubuntu) | Kindling_<version>_amd64.deb |
Native package for apt-based systems |
| Linux (Fedora/RHEL) | Kindling-<version>-1.x86_64.rpm |
Native package for dnf/rpm-based systems |
The .sig files next to each download are update signatures used by the in-app updater; you don't need them for a manual install.
To ensure you downloaded the authentic Kindling release:
- Download only from official sources: GitHub Releases
-
Verify checksums (optional but recommended):
- Download
checksums.sha256from the same release - Verify the file with your platform:
- Download
# macOS / Linux
shasum -a 256 -c checksums.sha256 --ignore-missing
# Windows (PowerShell)
certutil -hashfile Kindling_<version>_x64_en-US.msi SHA256If your checksum doesn't match, delete the file and re-download from the official release page.
- Kindling is open source and auditable: github.com/smith-and-web/kindling
- Release builds are produced by GitHub Actions in this repository
- Release assets include checksums for download verification
Kindling is code-signed and notarized by Apple. It should open without Gatekeeper warnings.
- Double-click the
.dmgfile to mount it - Drag Kindling to your Applications folder
- Double-click Kindling in your Applications folder to launch it
Kindling is not signed with a Windows code signing certificate. Windows SmartScreen may show a warning when you first run the installer.
- Download the
_x64-setup.exeinstaller (or the.msipackage) - Double-click to run it
- If you see "Windows protected your PC":
- Click More info
- Click Run anyway
- Follow the installation wizard
- Launch Kindling from the Start menu
After installation, Kindling will run without warnings.
SmartScreen warns about apps that don't have an established reputation with Microsoft. As more users download and run Kindling, this warning will eventually disappear. Code signing certificates are expensive ($200-500/year), so we've opted to ship unsigned for now.
AppImage is a portable format that works on most Linux distributions without installation.
# Download the AppImage
# Make it executable
chmod +x Kindling_*.AppImage
# Run it
./Kindling_*.AppImageTo add Kindling to your application menu:
# Install AppImageLauncher (recommended)
# Or manually create a .desktop file
# Move AppImage to a permanent location
mkdir -p ~/Applications
mv Kindling_*.AppImage ~/Applications/
# Create desktop entry
cat > ~/.local/share/applications/kindling.desktop << EOF
[Desktop Entry]
Name=Kindling
Exec=$HOME/Applications/Kindling_*.AppImage
Icon=kindling
Type=Application
Categories=Office;Writing;
EOFFor Debian-based distributions (Ubuntu, Linux Mint, Pop!_OS, etc.):
# Install the package
sudo dpkg -i Kindling_*_amd64.deb
# If there are dependency issues
sudo apt-get install -fLaunch Kindling from your application menu or run kindling in the terminal.
sudo apt remove kindlingFor RPM-based distributions (Fedora, RHEL, openSUSE, etc.):
# Install the package
sudo dnf install ./Kindling-*-1.x86_64.rpmLaunch Kindling from your application menu or run kindling in the terminal.
The macOS download is a single universal build (Kindling_<version>_universal.dmg) that runs natively on both Apple Silicon and Intel Macs, so there is no architecture to choose. Delete the app, re-download the DMG from the Releases page and drag it to Applications again.
Try running the installer as Administrator:
- Right-click the
_x64-setup.exeor.msifile - Select Run as administrator
Ensure FUSE is installed:
# Ubuntu/Debian
sudo apt install libfuse2
# Fedora
sudo dnf install fuseVersions up to 1.3.1 bundle an older libwayland-client, which on hosts with a
current Mesa (25 or newer) shadows the system copy and stops WebKit from creating
an EGL display. The window stays blank and stderr shows:
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...
Either use the .deb/.rpm package for your distro (they link the system
library), or run the AppImage with the host library preloaded:
# Debian/Ubuntu
LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libwayland-client.so.0 ./Kindling_*.AppImage
# Fedora/openSUSE
LD_PRELOAD=/usr/lib64/libwayland-client.so.0 ./Kindling_*.AppImageReleases built after this is fixed no longer bundle the library and need neither workaround.
AppImages don't always integrate with desktop environments automatically. Use AppImageLauncher or create a .desktop file manually (see above).
If you prefer to build Kindling yourself, see the README for instructions.