Files
lightcraft/docs/user/getting-started/install.md
T
Fabio LussiandClaude Opus 5.5 d3690e76c4 docs(user): apply final review fixes
Part 1: verified = latest release tag policy in docs/user/AGENTS.md; released-pages sentence in root AGENTS.md. Part 6: blank line in install.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 05:06:01 +02:00

56 lines
3.0 KiB
Markdown

---
title: Install LightCraft
description: Download LightCraft for Windows 11, macOS or Linux, install it, and open your photo library.
order: 10
verified: 0.6.0
---
Download the file for your system from the [latest release](https://github.com/storytold/lightcraft/releases/latest) and install it. In the file names, `<version>` stands for the version number, for example `0.6.0`. The [LightCraft page on getartcraft.com](https://getartcraft.com/apps/lightcraft) also links the download.
## Windows 11
1. Open the [latest release](https://github.com/storytold/lightcraft/releases/latest).
2. Download `lightcraft-<version>-windows-x64.msi`. It fits most PCs (Intel and AMD, 64-bit).
3. Run the file. The installer asks where to install. The default is `C:\Program Files\LightCraft`, and upgrades stay in the folder you chose.
4. At the end, choose the option to start LightCraft.
For a Snapdragon or other Arm PC, download `lightcraft-<version>-windows-arm64.msi` instead.
To run it without installing, download `lightcraft-<version>-windows-x64-portable.zip`. A portable build for `arm64` is on the release page too.
## macOS
1. Download `lightcraft-<version>-macos-universal.dmg`. It works on Apple silicon and Intel Macs, and is signed and notarized.
2. Open the file and install LightCraft.
## Linux
The release has these files for `x86_64` and `aarch64` (Arm). Replace `x86_64` with `aarch64` on Arm.
| File | Notes |
|----------------------------------------------|----------------------------------------------------------|
| `lightcraft-<version>-linux-x86_64.AppImage` | Runs anywhere. |
| `lightcraft-<version>-linux-x86_64.flatpak` | Sandboxed. Install with `flatpak install --user <file>`. |
| `lightcraft-<version>-linux-x86_64.deb` | For Debian and Ubuntu. |
| `lightcraft-<version>-linux-x86_64.rpm` | For Fedora, RHEL and openSUSE. |
| `lightcraft-<version>-linux-x86_64.tar.gz` | Unpack anywhere. |
RISC-V and FreeBSD builds are on the release page too. On a Wayland desktop, LightCraft runs through XWayland when it is available, because only X11 gives it file drag-and-drop.
## Install with ArtCraft Launcher
[ArtCraft Launcher](https://getartcraft.com/docs/craft-launcher) lists LightCraft and can install and update it for you. On Windows it installs the release `.msi`.
## In a web browser
The release also has `lightcraft-web-<version>.zip`, a static site that runs LightCraft in a modern browser. Host it on any static web server.
## First run
1. Start LightCraft. It opens your library at `~/Pictures/LightCraft Library`. A new library starts with demo photos.
2. To bring in your own photos, see [Import photos](../guides/import-photos.md).
## Still stuck?
Ask in [Discord](https://discord.gg/artcraft) or open an issue in the [issue tracker](https://github.com/storytold/lightcraft/issues).