Elicana
Blog Account Get Elicana
First-time setup

Installing Elicana

If you download Elicana in a browser rather than with the one-command install, your operating system will warn you before it lets it run. That warning is expected, and this page explains exactly what it means, why it's there, and the exact clicks to get past it, for Windows and Linux, with macOS documented in advance.

Jump to: Windows · Linux · macOS

The one-command install

The quickest path on every platform is one line in a terminal. It downloads the current build, checks it against our published checksums, installs it for your user only (no admin, no sudo), and opens the first-run setup in your browser.

macOS and Linux (Terminal):

curl -fsSL https://elicana.ai/install.sh | sh

Windows (PowerShell, not Command Prompt):

irm https://elicana.ai/install.ps1 | iex

Installing from the terminal skips the download warnings described below. If you would rather download a file and click it, the platform sections below give the exact clicks. You can read both scripts before running them: install.sh and install.ps1.

Windows

Download the 64-bit installer from elicana.ai/get, your welcome page, or your Account page.

What you'll see, and why

The Windows installer isn't code-signed with a Microsoft-trusted certificate yet, so Windows SmartScreen shows a "Windows protected your PC" screen the first time you run it.

Exact steps

  1. Run the downloaded .exe. If SmartScreen appears, click More info.
  2. A Run anyway button appears, click it.
  3. The installer runs with no admin rights required; it installs to your user profile.
  4. Launch Elicana from the Start Menu when it finishes.

You only need to click through SmartScreen once per download; Windows won't ask again for that exact file.

Verify your download

We publish SHA-256 checksums for every build at downloads.elicana.ai/latest/SHA256SUMS. To confirm your installer matches what we shipped, open PowerShell and run: 

(Invoke-WebRequest https://downloads.elicana.ai/latest/SHA256SUMS).Content -split "`n" | Select-String installer
Get-FileHash .\elicana-windows-amd64-installer.exe -Algorithm SHA256

The hash under Hash should match the one on the line Select-String found. If it doesn't, don't run the installer, re-download and check again, and if it still doesn't match email support@elicana.ai.

Linux

Download the amd64 or arm64 .tar.gz for your architecture from elicana.ai/get, your welcome page, or your Account page.

What you'll see, and why

Linux has no OS-level code-signing gate the way macOS and Windows do, so there's no security dialog to click through. The binary just needs the executable bit set, which the archive doesn't set for you.

Exact steps

tar -xzf elicana-linux-amd64.tar.gz   # or elicana-linux-arm64.tar.gz
bash install.sh

install.sh copies the binary to ~/.local/bin/elicana (no root needed), sets chmod +x on it, offers to create a desktop launcher entry (GNOME/KDE), and then opens the first-run setup wizard in your browser. If ~/.local/bin isn't already on your PATH, the installer tells you and prints the line to add to your shell profile.

The build is a static Go binary with no runtime glibc version requirement beyond what a mainstream 64-bit distro from the last several years already ships.

Verify your download

We publish SHA-256 checksums for every build at downloads.elicana.ai/latest/SHA256SUMS. To confirm your archive matches what we shipped, run: 

curl -s https://downloads.elicana.ai/latest/SHA256SUMS | grep linux
sha256sum elicana-linux-*.tar.gz

The hash sha256sum prints should match the one on the line the grep found. If it doesn't, don't run install.sh, re-download and check again, and if it still doesn't match email support@elicana.ai.

macOS

Elicana ships for Apple Silicon and Intel Macs as a terminal-installed app. Use the one-command install above; it is the supported path on macOS today.

What you'll see, and why

We are not yet certified in the Apple Developer Network, so a build downloaded through a browser shows an "unidentified developer" warning. The terminal install does not: files fetched with curl carry no quarantine flag, and the install shows no dialog. If macOS asks for permission to reach a folder when setup opens, that is the app asking to read the folder you chose.

Exact steps

  1. Open Terminal (Spotlight, then type "Terminal").
  2. Paste curl -fsSL https://elicana.ai/install.sh | sh and press Return.
  3. When the setup page opens in your browser, follow it. If it does not open, run elicana serve in the same Terminal window and open the address it prints.

Prefer a manual download? The archives are Apple Silicon and Intel. A file downloaded in the browser will carry the quarantine flag; the terminal install is simpler.

Still stuck?

Email support@elicana.ai with your macOS version and what the terminal printed. Include the exact wording of any dialog.

Verify your download

We publish SHA-256 checksums for every build at downloads.elicana.ai/latest/SHA256SUMS. To confirm your .dmg or .zip matches what we shipped, open Terminal and run: 

curl -s https://downloads.elicana.ai/SHA256SUMS | grep -i dmg
shasum -a 256 ~/Downloads/Elicana*.dmg

The hash shasum prints should match the one on the line the grep found. If it doesn't, don't open the app, re-download and check again, and if it still doesn't match email support@elicana.ai.

Stuck on something this page doesn't cover? Email support@elicana.ai with your OS version and a screenshot. That's the fastest way to get unblocked, and it's a direct line to me, not a ticket queue.