Help2023-11-18T17:49:24+00:00

Help

Small team, big heart! Your queries count.
Explore this page or join our Telegram. Patience appreciated!

Install Overview

Download Nirvati OS-based
Download balenaEtcher

Flash your Nirvati OS-based using balenaEtcher

Plug the USB stick into your device & restart it

Welc-Home to your Nirvati OS-based!

System Requirements

Nirvati OS-based Ecosystem: Compatibility and Edition Guide

Discover if your system is compatible with the Nirvati OS-based ecosystem and identify the most suitable edition for your machine.

Next are the minimum hardware specifications needed for OS installations. If your system doesn’t meet these criteria, running or OS might not be possible.

Nirvati OS | Citadel OS | Luxdis OS

Designed for mini PC.

CPU: 1 GHz Dual Core – Intel/AMD 64-bit processor
RAM: 2 GB
Storage: Nirvati OS = 10 GB | Luxdis OS = 10 GB | Citadel OS = +600 GB because of the weight of the downloaded blockchain.

Designed for Rasberry Pi.

Supported models: Raspberry Pi 4, 400, CM4 and 5
Storage: Nirvati OS = 10 GB | Luxdis OS = 10 GB | Citadel OS = +600 GB because of the weight of the downloaded blockchain.

How to Install our OS?

A step-by-step guide to help you install our Nirvati OS-based on your computer.

What you need

A computer capable of running our Nirvati OS-based.

View System Requirements ›

A USB flash drive with enough capacity for your OS.

An external drive, another computer or a cloud storage service that you trust for backup. (optional)

Pick Our Nirvati OS-based

Download your OS .iso file

Individual, familly or organization:
if you haven’t already downloaded your copy of one of our OS, you will need to get it from our website to proceed.

Download my Nirvati OS-based

Having issues with this step?
View what to do if you’re unable to download on of our Nirvati OS-based ›

Please keep the downloaded .iso file on your computer when following the next steps.

Back up your data

Data Backup Recommendation Before OS Installation

To ensure the safety of your important files, we suggest doing a backup. You can use an external drive, another computer or a cloud storage service that you trust.

This is important because your data will be overwritten when you install a new operating system.

Let us guide you 🕊️

1/3 | Create a bootable USB Install Drive

You will need to write the Nirvati OS-based .iso file to your USB flash drive using an app called balenaEtcher. The computer that you use to do this should be different from the computer you plan to install the Nirvati OS-based onto.

Download balenaEtcher
  • Plug the USB flash drive into your computer.
  • Double-click on the balenaEtcher download file to run the app.
  •  On Linux. If the balenaEtcher app doesn’t open after double-clicking on it, you may need to mark its downloaded “.AppImage” file as executable. To do so, right-click on the file in the file browser and open its Properties. Navigate to the Permissions section to enable the “Allow executing file as program” option.

– Press “Flash from file” and select the downloaded your Nirvati OS-based .iso file on your computer. The file should be in your “Downloads” folder.

– Press “Select target” and choose the correct USB flash drive in the list.

– Press “Flash!” to begin writing Nirvati OS-based to the USB flash drive.

– After a few minutes, the USB flash drive will be ready for booting into Nirvati OS-based.

2/3 | Installing your chosen OS on your computer

Plug the Nirvati OS-based USB Install Drive into your computer.

  • On a PC. Switch on your computer. Immediately at start-up, repeatedly press the designated key to open the BIOS. If you’re unsure which key to press, it is usually either Esc, Delete, F2, F12, or another function key.

– Using the arrow keys navigate to the Boot Section, and make sure the Boot Device with higherst priority is the USB with Nirvati. Then Save and Exit; this will reboot the device.

– Select the “Try or Install Nirvati OS-based” option in the Nirvati OS-based boot selection menu using the Enter key.

  • On a Mac. Press and hold the ⌥ Option key at start-up. If you’re using a wireless keyboard, you may need to plug it in with a cable.

– Select the Nirvati OS-based USB, which should be named “EFI Boot”, then press Enter (Sometimes it might be incorrectly identified as “Windows”)

– Select the “Try or Install Nirvati OS-based” option in the Nirvati OS-based boot selection menu using the Enter key.

3/3 | Installing your chosen OS on your computer

  • Once the installation process is finished, you can turn off the device and place it in its final location.
  • Connect it via Ethernet cable to your home router and plug in the power plug. Neither display nor mouse and keyboard are needed anymore.
  • With any device connected to your home network, open any browser and:
    • for Nirvati OS, type: “nirvati.local” then press Enter
    • for Luxdis OS, type : “luxdis.local” then press Enter
    • for Citadel OS, type: “citadel.local” then press Enter

Welc-Home, ✅

FAQs

Terminology
GUI = Graphical user interface – in this case a web browser
CLI = Command line interface – in this case a terminal

How to access your node (GUI)?2023-11-18T23:15:22+00:00

  • Open any browser
  • Type in the address bar citadel.local or your node’s IP address – for help see Need your node’s IP address?
  • type your password
Share This Answer, Choose Your Platform!
I have installed Citadel OS, what now?2023-11-18T23:17:07+00:00

  • Open the browser from any of your devices
  • Type in the address bar citadel.local or your node IP address – for help see Need your node’s IP address?
  • type in your password
  • enjoy Citadel OS
Share This Answer, Choose Your Platform!
Need your node’s IP address?2023-11-18T23:16:31+00:00

  • Install Angry IP Scanner here
  • Open Angry IP Scanner and press “Start”
  • Identify the IP address of your node looking at “Hostname” and “Ping” (keep in mind that Ethernet has lower ping than Wifi)
Share This Answer, Choose Your Platform!
Want to SSH into your node? (CLI)2023-11-18T23:15:55+00:00

  • Open the Terminal on any device you want to use for SSH into your node
  • write ssh [account_name]@citadel
  • Replacing [account_name] with citadel for Citadel OS v0.2.x, and nirvati for Citadel OS v0.3.x (Nirvati technical preview).
  • If this fails, try ssh [account_name]@citadel.local or ssh [account_name]@[ip_address], replacing [ip_address] with the IP address of your node – for help see Need your node’s IP address?
Share This Answer, Choose Your Platform!
Want to shutdown your node? (GUI)2023-11-18T23:14:19+00:00

Share This Answer, Choose Your Platform!
Want to restart your node? (GUI)2023-11-18T23:13:42+00:00

Share This Answer, Choose Your Platform!
Want to update Citadel (GUI)?2023-11-18T23:13:10+00:00

  • Access your node – for help see How to access your node (GUI)?
  • go to “Settings”
  • press “Check for updates”, then “Install Now” if there are any updates
Share This Answer, Choose Your Platform!
Need logs for troubleshooting (GUI)?2023-11-18T23:12:40+00:00

Share This Answer, Choose Your Platform!
Need logs for troubleshooting (CLI)?2023-11-18T23:12:11+00:00

Share This Answer, Choose Your Platform!
Want to start Citadel (CLI)?2023-11-18T23:11:41+00:00

Share This Answer, Choose Your Platform!
Want to stop Citadel (CLI)?2023-11-18T23:10:51+00:00

Share This Answer, Choose Your Platform!
Want to install an app (CLI)?2023-11-18T23:10:57+00:00

  • SSH into your node – for help see Want to SSH into your node?
  • write sudo ~/citadel/scripts/app install [app_name] replacing [app_name] with the name of the app you wish to install e.g. fulcrum
Share This Answer, Choose Your Platform!
Want to do a full reset (BACKUP EVERYTHING FIRST) (CLI)?2023-11-18T23:11:04+00:00

  • Backup every data that is important on a secure device different from your node.
  • SSH into your node – for help see Want to SSH into your node?
  • write sudo ~/citadel/scripts/stop
    && sudo rm -rf ~/citadel/app-data/* && sudo rm -f
    ~/citadel/statuses/configured ~/citadel/db/user.json
    ~/citadel/db/citadel-seed/seed && sudo ~/citadel/scripts/start
    && sudo ~/citadel/scripts/start
Share This Answer, Choose Your Platform!
Need additional help (GUI)?2023-11-18T23:06:55+00:00

Share This Answer, Choose Your Platform!
Need additional help (CLI)?2023-11-18T23:05:05+00:00

  • Generate logs for Troubleshooting CLI – for help see Need logs for troubleshooting (CLI)?
  • Copy the sharable link you get
  • Join the Citadel’s Telegram Group, describe in detail what happened and attach the logs file.
  • have patience 🙂 We are a small team, but we are trying our best to get back to you asap!
Share This Answer, Choose Your Platform!

🏗️

🏗️

Go to Top