Basics
Installation
Getting Kiln onto your computer, and what you need to run code.
Overview
Windows
Kiln for Windows comes as a setup wizard, Kiln-Setup-1.1.0.exe. It installs Kiln just for you — no administrator password needed.
- Download Kiln-Setup and open it.
- Click Next. Choose whether you want a desktop shortcut (a Start menu shortcut is always added).
- Keep the suggested folder (
AppData\Local\Programs\Kiln) or pick another, and click Install. - Leave Open Kiln now ticked and click Finish.
The setup lists Joelin Studios as the publisher and carries full version information. Kiln gets its own folder; nothing outside it is changed.
Chrome or Edge blocked the download
Browsers flag programs that aren’t code-signed and that few people have downloaded yet. Kiln 1.1.0 isn’t signed yet, so this can happen even though nothing harmful was found. To keep the file:
- Chrome: press Ctrl+J, then next to Kiln-Setup click ⋮ (or the warning) and choose Download suspicious file (older versions say Keep).
- Edge: press Ctrl+J, hover over Kiln-Setup, click … → Keep, then Show more → Keep anyway.
- “Insecure download blocked” means the page was opened over plain http://. Use the https:// address.
Before opening it, you can check it’s the real file: in PowerShell run Get-FileHash $HOME\Downloads\Kiln-Setup-1.1.0.exe and compare the Hash with the SHA-256 on the download page.
“Windows protected your PC”
Windows SmartScreen shows this for programs that aren’t digitally signed with a code-signing certificate, or that few people have downloaded yet. Builds of Kiln 1.1.0 are not signed yet, so you may see it. Click More info, check the app name says Kiln-Setup, then Run anyway.
Updating and uninstalling
- Kiln checks for updates when it starts. When a new version is out it asks first, then downloads it, checks it, installs it and reopens. You can also run Help: Check for updates, or turn checking off in Settings → Updates. Running a newer setup yourself works too; it keeps your settings and projects.
- To uninstall, open Settings → Apps → Installed apps, find Kiln, and choose Uninstall. It removes only the files it installed — your settings and projects stay where they are.
macOS
- Download the zip for your Mac — Apple silicon (M1 and later) or Intel. Apple menu → About This Mac tells you which.
- Open the zip and drag Kiln into Applications.
- Kiln isn’t notarized by Apple yet, so the first time, right-click Kiln → Open, then Open. If macOS only offers “Move to Bin”, open System Settings → Privacy & Security and click Open Anyway.
Kiln needs macOS 13 Ventura or later. When there’s a new version, Kiln tells you and opens the download page.
Linux
- .deb (Ubuntu, Debian, Mint, Pop!_OS):
sudo apt install ./kiln_1.1.0_amd64.deb. Kiln appears in your apps menu; remove it withsudo apt remove kiln. - .tar.gz (any distribution): unpack it anywhere and run
./kilnin the folder.
Languages and tools
Kiln runs your code with the language tools already on your computer. JavaScript and TypeScript work out of the box — Kiln uses its built-in Node.js runtime when Node isn’t installed. For other languages, install the language and Kiln finds it on your PATH automatically.
Install for me (Windows)
On Windows, Kiln can install C/C++ (GCC), Python and Java for you. The first time you run code in a language that isn’t installed — or start a course that needs one — Kiln offers Install for me. It downloads the official release, checks it against a pinned SHA-256 checksum, and unpacks it into Kiln’s own folder. Nothing is installed system-wide and there’s no admin prompt. Remove them from the Extensions view. On macOS and Linux, Kiln shows the one command to install each language instead.
| Language | What Kiln looks for |
|---|---|
| Python | Python 3 (python3, python or py) |
| C / C++ | gcc / g++ or clang / clang++ |
| Java | A JDK with java (single-file programs run directly) |
| Go | go |
| Rust | rustc |
| Others | Ruby, PHP, Lua, shell scripts, PowerShell, C# (dotnet run app.cs) |
Open the Extensions view to see which toolchains Kiln found and their versions. Use Run: Re-detect installed toolchains after installing something new.
Optional extras
- Git for source control.
- clangd for C/C++ autocomplete and error hints. On Windows, install it from the Extensions view (C/C++ smart help).
- Formatters — ruff or black (Python), clang-format (C, C++, Java), gofmt, rustfmt — used by Format document.
- An AI provider for the assistant and tutor. See Settings.