ANNE Wizard: The Essential ANNE Installation Suite

ANNE Wizard is a cross-platform installation suite that automates the setup of the ANNE ecosystem. It handles dependencies installation, database configuration with a pre‑imported chain snapshot, firewall rules, desktop shortcuts, and more. All in a single graphical wizard.

Features

• Easy installation of ANNE Node, ANNE Hasher, and ANNE Miner.
• Automated dependency handling (Java, MariaDB) using native package managers.
• Datachain snapshot import – downloads and imports the latest chain snapshot into MariaDB.
• Automatic configuration – sets up node.properties, miner settings (config.yaml), firewall rules (port 9115), and desktop/menu shortcuts.
• Cross‑platform – runs on Linux (dnf/apt/pacman), and macOS 10.15+ (Catalina+), and Windows 10/11

*For non-supported platforms, or if you prefer manual installation or your OS is headless, see the Installation Guide. It is intended for advanced users, those who want to learn what it takes to install ANNE manually, or anyone needing to run a headless annode on a server without a desktop environment.

Get Started with ANNE in Minutes

What the Wizard Does For You

• Install ANNE for the first time – complete setup from scratch.
• Upgrade existing installations – run the wizard again to update ANNE Node, Hasher, and Miner to the latest versions. Your existing configuration and keys will be preserved.
• Re-import the chain snapshot – if you need to reset your database or recover from an inconsistent database, run the wizard again and choose to re-import the snapshot (this will not affect your ANNE Node configuration and keys).
• Create another instance – run the wizard in a different directory to set up a second independent ANNE Node (e.g., for testing or separate networks). Use the “Custom Install Location” option when available.

Note: Because ANNE Wizard is open‑source software distributed without a paid code‑signing certificate, Windows and macOS may show security warnings when you first run it. This is normal. The app is safe, and the warnings only appear because our build is not signed with a widely‑trusted certificate.

Download the Latest Release

Head over to the Releases page and download the installer for your operating system

Linux

Make sure the AppImage has executable permissions and open it from your file explorer.

macOS

Open the dmg and drag the app to your Applications folder, run it from there. If you get an unidentified developer warning, either change the settings under System Preferences > Security & Privacy > General > Allow applications downloaded from: to Anywhere or in a Terminal, OR strip the xattr com.apple.quarantine attribute from the downloaded file, like so:

cd /Applications
xattr -dr com.apple.quarantine "Anne Wizard.app"

Alternatively, you can bypass the quarantine by downloading the app via Terminal, like so:

curl -L -o  anne-wizard-macos.zip https://github.com/annemedia/anne-wizard/releases/download/v1.0.0/anne-wizard-macos.zip

Windows

Run the exe, and if you get a warning "Windows Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.", click on More info and Run anyway.

Alternatively, you can avert the SmartScreen by downloading the app via PowerShell, like so:

curl -o  anne-wizard-windows.zip https://github.com/annemedia/anne-wizard/releases/download/v1.0.0/anne-wizard-windows.zip

or Command Prompt:

curl -L -o  anne-wizard-windows.zip https://github.com/annemedia/anne-wizard/releases/download/v1.0.0/anne-wizard-windows.zip

Important: Your Node Identity (Keys)

A critical part of your ANNE Node is its cryptographic identity: the Seed (secret) and Account ID (NID). Once your ANNE Node has been running and has peers, changing these keys may break peering. Nodes you've previously peered with may refuse to connect with your peer because they remember your IP+port against the old NID. To attain bi-directional communication with those peers, you would need to either change IP or Port, or request manual intervention from the remote peer ends through community channels, or wait for them to recover preferences for your peer on their end. Best if you do not change your node’s identity after it has been running.

What Happens When You Run the Wizard Again?

• If your installation folder (e.g., ~/ANNE or C:\Program Files\ANNE) still exists and contains the encrypted node.properties file, the wizard will skip the configuration pages (the ones where you enter keys and network settings). It will simply update the binaries and snapshots without touching your existing node identity.
• If you delete the installation folder (or choose a new empty folder), the wizard treats it as a fresh install and will show all configuration pages, allowing you to create new keys.
• If you want to keep your existing keys but need to reconfigure something, you have two options:
  1. Run the wizard and accept the defaults – your keys will be changed. After the wizard finishes, replace the node.properties file with a backup of your original node.properties before starting the node.
  2. Manually edit node.properties after installation, simply run your ANNE Node and edit the keys in the provided Text Editor. Or, if properties are not yet encrypted, you may edit them ahead of time, found in the following default locations:
     • Linux/macOS: ~/ANNE/annode/conf/node.properties
     • Windows: C:\Program Files\ANNE\annode\conf\node.properties

After Installation

• Start ANNE Node from the desktop or start menu shortcut.
• Once synced, open your browser to http://localhost:9116/ANNE.html to access the main applications, eg. Web Wallet, Annex, LUKAT, or http://localhost:9116/aon.html to access Numiner or Swaps.
• To mine, run ANNE Hasher to plot your drives, then start ANNE Miner.

Once your ANNE Node is running, a few additional steps will help ensure reliable connectivity and smooth operation.

Open peer-to-peer port on your router

Your ANNE Node uses the peer-to-peer port 9115 (or custom) to connect with other annodes.: If behind a router, exact steps vary by router brand/model – check your router’s manual for specifics. Ensure your device has a static LAN IP to avoid issues.

• Log in to your router: Open a web browser, enter your router’s IP address (e.g., http://192.168.0.1), and log in with your admin username and password (check router manual or sticker if unsure).
• Find Port Forwarding settings: Look for a section like “Port Forwarding,” “Virtual Server,” or “Firewall” in the router’s menu.
• Add a new rule: Choose TCP protocol, enter the port number 9115 or custom if you changed it.
• On your computer, find the “LAN IPv4 address” for your connection
  • on Windows, open Command Prompt and find your LAN IP address with ipconfig | findstr "192"
  • on Linux, open Terminal and find your LAN IP address with ip -4 addr show | grep 'inet 192' | awk '{print $2}' | cut -d'/' -f1
  • on Mac, open Terminal and find your LAN IP address with ipconfig getifaddr en0 | grep '^192'
• On your router, specify the local IP address you found (e.g., 192.168.0.100), and Save the rule.
• Apply changes: Click “Save” or “Apply” and wait for the router to restart if needed.
• Test it: Use an online tool (e.g., https://yougetsignal.com/tools/open-ports to check if the port is open.

Verifying the Download

If you prefer to verify the software before running, you can inspect the source code, build it yourself, or compare the checksum of the downloaded binary against the one published in the release notes.

Prerequisites

To build ANNE Wizard from source you need:

• CMake (3.20 or later)
• Qt6 (6.10.1 recommended) with the following components:
  • Core
  • Widgets
  • Network
  • Qml
  • Concurrent
  • DBus
• A C++17 compiler (MinGW (recommended), MSVC, GCC, Clang)
• Ninja (optional)

Building from Source

General CMake Build

git clone https://github.com/annemedia/anne-wizard.git
cd anne-wizard
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

The executable will be placed in build/annewizard

Platform‑Specific Instructions

Get QT Online Instaler or see setup.sh provided in the repository.

Linux (AppImage)

Use the provided script build_linux.sh (adjust paths)

Get:

• linuxdeployqt – linuxdeployqt or
• appimagetool – appimagetool , or both.

macOS (DMG)

Use the provided script build_mac.sh (adjust paths)

Windows

Dynamic Build

# Ensure Qt6 is in PATH or set QT6_DIR
$env:QT6_DIR = "C:\Qt\6.10.1\mingw_64"   # adjust to your Qt installation
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
# Deploy Qt libraries
C:\Qt\6.10.1\mingw_64\bin\windeployqt.exe build\annewizard.exe

Static Build

Build a static Qt6, see instructions in build_windows file provided in the repository (adjust paths)

Contributing

We welcome contributions! You can help by:

• Reporting bugs or suggesting features via GitHub Issues
• Submitting pull requests for bug fixes or improvements
• Improving documentation
• Adding translations

For discussions, join our community at ANNE Forum.

Limitations

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Acknowledgements & Attribution

This application is licensed under The Unlicense License. It uses the Qt framework under the terms of the GNU Lesser General Public License, version 3 (LGPLv3).

• A copy of the LGPLv3 license is included in this repository as LICENSE.LGPLv3. For more information about Qt and its licensing, visit https://www.qt.io/licensing/ and Qt framework – qt.io

• linuxdeployqt – linuxdeployqt

• appimagetool – appimagetool

• ANNE Official – anne.network

• ANNE Media – anne.media

• The ANNE community – annetalk.org

      __/\__
. _   \\''//
-( )--/_||_\\
 .'.  \_()_/
  |    | . \
  |anne| .  \  
 .'.  ,\_____'.

  Power to the people.