Home / Users / Installation

Installation

Lexicon is built from source with CMake and Qt 6. It runs on Linux, Windows, and macOS.

Requirements

Linux (Debian / Ubuntu)

1. Install the build tools and Qt 6:

   sudo apt update
   sudo apt install -y build-essential cmake qt6-base-dev libqt6sql6-sqlite

2. Get the source code:

   git clone https://github.com/robertvokac/lexicon.git
   cd lexicon

3. Configure and build:

   cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
   cmake --build build --target Lexicon -j

4. Run it:

   ./build/Lexicon

Windows

1. Install Qt 6 using the official Qt Online Installer, including the MSVC or MinGW toolchain matching your compiler.
2. Install CMake (3.21+) and make sure it is on your PATH.
3. Configure and build from a shell where Qt is discoverable (e.g. the Qt command prompt), pointing CMake to your Qt installation:

   cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=C:\Qt\6.7.0\msvc2019_64
   cmake --build build --target Lexicon --config Release

4. Run build\Release\Lexicon.exe. On Windows, Lexicon builds as a GUI application (no console window).

macOS

1. Install the prerequisites with Homebrew:

   brew install cmake qt@6

2. Configure, build, and run:

   cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$(brew --prefix qt@6)"
   cmake --build build --target Lexicon -j
   ./build/Lexicon

First launch

There is no setup wizard — Lexicon takes care of itself:

• On startup, Lexicon creates or opens the database file lexicon.db in the same directory as the executable.
• Database migrations are applied automatically, so upgrading to a newer Lexicon version never requires manual steps.
• Your theme preference (light/dark) is remembered between sessions.