Neruna Join the beta

Documentation

Getting started and help.

Short and practical: install, set up accounts, connect – and what to do when something sticks.

Install

  1. Request the beta and download the installer “Neruna-win-Setup.exe” – or the ZIP without installation.

  2. Run it. Windows SmartScreen asks because the beta isn't signed yet: “More info” → “Run anyway”.

  3. Done. The installed version fetches updates itself and installs them at the next start.

WebView2 (preinstalled on Windows 11) · Windows 10 or 11, 64-bit

Set up an email account

  1. At first start, “Add account” opens – later under Settings → Accounts.

  2. Choose “Email account”, enter name, address and password. Neruna looks for IMAP, SMTP, CalDAV and CardDAV itself; you can check and change what it finds.

  3. Extra sender addresses (aliases) and an account label like “Office” can be added any time under “Edit”.

Microsoft 365 and Outlook.com

Under “Add account” choose “Microsoft 365 / Outlook.com” and “Sign in with Microsoft”. The browser opens; after signing in, mailbox, calendar and contacts arrive. Some companies require IT to approve Neruna once – Microsoft then says “Admin approval required”.

Connect to Neruna Cloud With Neruna Cloud

Settings → Cloud: enter the connection code from the “Connect Neruna Desktop” email and the 6-digit PIN you receive separately. Your organisation's signatures, templates, certificates and accounts then arrive on their own.

Key settings

Languages
Settings → Appearance → Language (takes effect after a restart)
Appearance
Light, dark or like the system; colour scheme blue, red or green
Signatures & templates
Settings → Signatures or Text templates, per account for new messages and replies
S/MIME
Settings → Certificates: import your own (.p12/.pfx), choose signing and encryption strength
Crash reports
Settings → About: ask every time (default), send automatically or never

When something sticks

Windows warns
The beta isn't signed with a code-signing certificate yet, so Windows SmartScreen asks first – continue with “More info” → “Run anyway”. A signed installer will follow.
Logs
Settings → Accounts → Diagnostics: open the data folder and logs. Passwords never appear in the logs.
No formatted writing
The editor needs WebView2 (preinstalled on Windows 11; Windows 10: Microsoft's “WebView2 Runtime”). Without it, you write plain text.
Still stuck?
Write to us: info@neruna.org

Good questions.

Is Neruna Desktop really free?

Yes. The client is open source (Mozilla Public License 2.0) and costs nothing – not even for companies. We'll make money later with Neruna Cloud and Control, the central management for teams.

Which servers does Neruna work with?

With anything that speaks IMAP/SMTP for mail and CalDAV/CardDAV for calendars and contacts – so most providers and mail servers. Plus Microsoft 365 and Outlook.com via the Microsoft sign-in. Internet calendars can also be subscribed via ICS/webcal.

What about Exchange servers?

Exchange Online (Microsoft 365) yes: mail, calendar and contacts, and you sign in directly with Microsoft – Neruna never sees your password. A provider for on-premises Exchange servers (EWS) is on the roadmap; until then they work for mail, as long as IMAP is enabled.

Where is my data?

On your mail server – and as an offline copy on your computer. We don't host mail, events or contacts. Passwords are never stored in plain text. The only exception is the chat, and only with Neruna Cloud: messages are kept there as long as your organisation decides. Without Neruna Cloud there is no chat – and no user data with us.

Can I see subscribed and shared calendars?

Yes – and not only during setup: under “Manage calendars”, Neruna asks the server again at any time and shows newly subscribed calendars as “new”.

What language is the app in?

In German, English, French and Italian – like your system at first start, switchable under Settings → Appearance → Language.

Is Neruna available for Linux or macOS?

Neruna is built cross-platform from the ground up (.NET and Avalonia). The beta comes for Windows first; Linux and macOS packages will follow.

Why does Windows warn me on first start?

The beta isn't signed with a code-signing certificate yet, so Windows SmartScreen asks first – continue with “More info” → “Run anyway”. A signed installer will follow.