How to Install an Annode


 
by Ironshirtz
Last Updated: 19/04/2025

For basic windows users you simply run the ANNE web installer which will take care of everything for you. Be sure your machine meets the minimum requirements and you have a few things ready and you should be up and running in no time.

* You can watch a short video of setting up an account and installing an Annode HERE

* To ensure data integrity the windows easy installer will not run if you already have mariaDB mysql installed. Advanced users may install ANNE manually by following intructions HERE


Quick setup guide (windows)

  1.  Run the installer
  2.  Enter NID, Secret and memorable config password
  3.  Make a cuppa while the installer does its thing
  4.  Set memorable config password in the Annode
  5.  Enjoy that cuppa while the Annode syncs to the network

Prerequisites

  • Onboarded NID set with ID type: Annode
  • The Secret for the NID

IMPORTANT: Your Annode NID must already be onboarded with the ID type set as: Annode, please see Onboarding a new NID for instructions.

Minimum PC System Requirements (assuming mining)

  •    64-bit Operating System
  •    4 Core CPU
  •    8GB RAM
  •    64GB SSD

Recommended PC System Requirements (assuming mining)

  •    64-bit Operating System
  •    8 Core CPU
  •    16GB RAM
  •    128GB SSD

*The annode has been tested on Windows 8.1/10/11, Linux Debian, RHEL, and R-PiOS.

Installing ANNE on Windows 10/11

Start by downloading the ANNE Easy Web Installer

Run the installer, enter Annode NID, secret and a memorable config password, click OK

Enter NID, Secret and Password
Enter NID, Secret and Password

*Depending on your setup you may need to confirm installations.


Once the installation is complete the Annode will start and you will be prompted by the ANNE Encrypted text file viewer to set a password. Enter the exact same memorable password you provided at start to set it as the Annode config password.

Set your Annode config password
Set your Annode config password

That's it you are all done. If prompted by your firewall, be sure to allow Java all network access.

For your convenience an AnneStart.exe file containg your config password has been created at C:\ANNE\Tools while your password is not stored in plain text, this is by no means 100% secure, should your machine ever be compromised, with some time and effort it is possible the exe could be decompiled. This exe file allows the Annode to run at windows startup without requiring the password be entered manually. The most secure option would be to manually enter your password at each start and not store it anywhere. You can do this by replacing the default AnneStart.exe file in C:\ANNE\Tools with the file in the C:\ANNE\Tools\RPW folder. Using the file from the RPW folder, you will be prompted to enter the password manually at each start.

NOTE: Another option to reduce or limit risk, is to setup a STREAMPAY or multiple streampays. A streampay can be created to schedule payments to a cold wallet or any NID of your choice.


Installing ANNE on Linux


Warning: DO NOT RUN THIS SCRIPT IF YOU HAVE EXISTING MARIADB DATABASES YOU CAN'T LOSE. If MariaDB is already installed, it will be reinstalled. Albeit, you will be prompted to purge it (losing existing databases) or abort.

Download the Script: 

wget https://raw.githubusercontent.com/annemedia/annode-install/main/annode-install.sh


Run the Script:

  • Your ANNE Neuron ID (NID) and secret (seed) are required
  • The NID should be onboarded with Annode ID type
  • Replace "your-nid" and "your-seed" below
Note: Use 'sudo -E' to preserve the user environment 
sudo -E bash annode-install.sh your-nid your-seed
Post installation:
Important: After running the script, you will see terminal output with important details: MariaDB Passwords: The root password and anneroot user password for the annedb database. Record these immediately—they are not saved elsewhere and are needed for database access.
Starting the Annode:
To Start the Annode: 
sudo systemctl start annode.service
Check its status: 
systemctl status annode.service
For GUI mode, edit /usr/bin/annode.sh, remove the --headless flag, and restart: 
sudo systemctl restart annode.service
GUI environment: Start manually from terminal 
annode.sh
Upgrading the Annode:
Download the ypgrade script: 
wget https://raw.githubusercontent.com/annemedia/annode-install/main/annode-upgrade.sh
Run the upgrade script: 
sudo bash annode-upgrade.sh

Troubleshooting:
Ensure port 9115 or custom port (if you changed it) is open, if using a custom firewall other than csf, uwf or firewalld; the script skips this if no supported firewall is detected. Also if you're on LAN or behind a router, make sure the port is open/forwarded to your LAN IP in your router firewall.
Only Debian or RHEL-based linux are supported.

Installing ANNE on MacOS

No instructions, but hey you got a mac!


This website is hosted from home via the ANNE network

Visit the official website ANNE.network

Back to top