Installation

Installation

Download and install Kindling on your platform.

Download

Get the latest release from the GitHub Releases page.

Available Downloads

Platform	File	Description
macOS (Apple Silicon)	Kindling_*_aarch64.dmg	For M1, M2, M3 Macs
macOS (Intel)	Kindling_*_x64.dmg	For Intel-based Macs
Windows	Kindling_*_x64-setup.msi	Windows installer
Linux	Kindling_*_amd64.AppImage	Portable, works on most distros
Linux (Debian/Ubuntu)	kindling_*_amd64.deb	Native package for apt-based systems

---

Verify Your Download

To ensure you downloaded the authentic Kindling release:

1. Download only from official sources: GitHub Releases
2. Verify checksums (optional but recommended):
   • Download checksums.sha256 from the same release
   • Verify the file with your platform:

# macOS / Linux
shasum -a 256 -c checksums.sha256 --ignore-missing

# Windows (PowerShell)
certutil -hashfile Kindling_*_x64-setup.msi SHA256

If your checksum doesn't match, delete the file and re-download from the official release page.

Trust Signals

• 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

---

macOS Installation

Kindling is code-signed and notarized by Apple. It should open without Gatekeeper warnings.

1. Double-click the .dmg file to mount it
2. Drag Kindling to your Applications folder
3. Double-click Kindling in your Applications folder to launch it

---

Windows Installation

Kindling is not signed with a Windows code signing certificate. Windows SmartScreen may show a warning when you first run the installer.

Bypassing SmartScreen

1. Download the .msi installer
2. Double-click to run the installer
3. If you see "Windows protected your PC":
   • Click More info
   • Click Run anyway
4. Follow the installation wizard
5. Launch Kindling from the Start menu

After installation, Kindling will run without warnings.

Why This Warning Appears

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.

---

Linux Installation

AppImage (Recommended)

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_*.AppImage

Optional: Desktop Integration

To 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;
EOF

Debian/Ubuntu (.deb)

For Debian-based distributions (Ubuntu, Linux Mint, Pop!_OS, etc.):

# Install the package
sudo dpkg -i kindling_*.deb

# If there are dependency issues
sudo apt-get install -f

Launch Kindling from your application menu or run kindling in the terminal.

Uninstalling

sudo apt remove kindling

---

Troubleshooting

macOS: App crashes immediately

Ensure you downloaded the correct version:

• Apple Silicon (M1/M2/M3): aarch64.dmg
• Intel: x64.dmg

Check your Mac's chip: Apple menu → About This Mac → Chip/Processor.

Windows: Installer fails silently

Try running the installer as Administrator:

1. Right-click the .msi file
2. Select Run as administrator

Linux: AppImage won't start

Ensure FUSE is installed:

# Ubuntu/Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse

Linux: No application icon

AppImages don't always integrate with desktop environments automatically. Use AppImageLauncher or create a .desktop file manually (see above).

---

Building from Source

If you prefer to build Kindling yourself, see the README for instructions.