Petko: Removed link to https://www.ardor.world/faucet_ardor/ and substituted the link to https://ardorforum.org/ with https://talk.jelurida.com/t/ardor-tesnet-tokens/1325

2026-05-14T17:33:17Z

Removed link to https://www.ardor.world/faucet_ardor/ and substituted the link to https://ardorforum.org/ with https://talk.jelurida.com/t/ardor-tesnet-tokens/1325

← Older revision		Revision as of 17:33, 14 May 2026
Line 173:		Line 173:

	<!--T:79-->		<!--T:79-->
	~~The process for receiving~~ testnet tokens ~~is simple. Ask~~ for them in the [https://~~ardorforum~~.~~org Ardor Forum~~], contact us on the [https://ardornxt.slack.com slack] channel #helpdesk~~. There is an external [https://www.ardor.world/faucet_ardor/ faucet] as well~~.		To receive testnet tokens, ask for them in the [https://talk.jelurida.com/t/ardor-tesnet-tokens/1325 forum] or contact us on the [https://ardornxt.slack.com slack] channel #helpdesk.

Admin: instructions for use of zip file on MacOS

2024-04-19T19:33:15Z

instructions for use of zip file on MacOS

@@ Line 43: / Line 43: @@
 <!--T:39-->
 #Download the Mac installer for the latest official Ardor Client  {{NRSVersion}} from {{NRSMacInstaller}}. After downloading, [[Faq#How_to_verify_authenticity_of_Ardor_installations|verify its signature]]. After downloading, check the SHA256 hash of the package for security. If you want to test the latest testnet-only version {{NRSVersionExperimental}} that includes the snapshotting and pruning functionality, refer to the Universal Zip Package.
 #Open the MacOS terminal.

Almonte at 22:41, 7 June 2022

2022-06-07T22:41:23Z

New page

{{#seo:
|title=Getting started
|titlemode=replace
|keywords=ardor learning hub, ardor documentation, blockchain, proof of stake, ardor, ignis, jelurida, development, ardor wiki, wiki
|description=Ardor documentation homepage - Getting started with the Ardor platform
}}
<languages />
<translate>


[https://www.jelurida.com/ardor Ardor] is a blockchain-as-a-service multi-chain platform that evolved from the time-tested and energy-efficient [https://www.jelurida.com/nxt Nxt blockchain]. The Ardor mainnet launched on 01 January 2018. Through this documentation, you will learn all about the extensive capabilities of the Ardor platform. Begin developing your knowledge by reading about each of Ardor’s distinctive [[Features]] or consider trying the technology yourself by following some [[Basic tutorials|Basic Tutorials]]. For developers, documentation is provided for each of Ardor’s more than 250 [[API|APIs]] that can be used to quickly and cost-effectively deploy dApps and smart contracts that integrate your business processes with the Ardor blockchain. Check this site regularly for new content and updates as additional features are released.

==Download Ardor== 


Before we begin, if you haven’t already done so, you may wish to check that you have the correct (usually most recent) version of [https://adoptopenjdk.net/ Java] installed on your computer. You can use any compatible Java available for your platform. The minimum required version is Java 8. The recommended version is Java 11. We usually test with OpenJDK 14.


To start with Ardor/[https://www.jelurida.com/ignis Ignis], you must first download the client, also known as a "wallet", on your machine. The client is distributed as a binary package for the following platforms:


[[File:200px-Windowslogo.jpg|100px|frameless|link=Getting_started#Windows]][[File:200px-AppleLogo.jpg|100px|frameless|link=Getting_started#MacOS]][[File:200px-Linuxlogo.jpg|130px|frameless|link=Getting_started#Linux]][[File:200px-RaspberryPi_Logo.png|100px|frameless|link=Getting_started#Raspberry_Pi]][[File:200px-Android.png|100px|frameless|link=Getting_started#Android]]

==Client Installation == 


<div class="accordion" id="accordion-win">
<accordion parent="accordion-win" heading="===Windows===">
#Download the Windows installer for the latest official Ardor Client {{NRSVersion}} from {{NRSWinInstaller}}. If you want to test the latest testnet-only version {{NRSVersionExperimental}} that includes the snapshotting and pruning functionality, refer to the Universal Zip Package.
#Ardor's Windows client comes as an .exe file. After downloading it, you can verify its integrity by performing an [[Faq#How_to_verify_authenticity_of_Ardor_installations|integrity check]]
#Run the installer and follow the instructions on the screen. Note that you can select either the testnet or mainnet during installation, if further details are needed please follow the [[How_to_download_the_ardor_client_wallet|step-by-step guide]]. Once installed icons will be created by default in your desktop and Start Menu.
#You can now run the Ardor software by clicking on the Ardor icon. After a few seconds, the Ardor wallet will open in its own window.
#If you already have created an Ardor account, click on 'Returning User' to introduce your passphrase. If you need to create your Ardor account, [[How_to_create_an_account_on_the_Ardor_Platform|click here for instructions to Create a New Ardor Account]].
</accordion>
</div>


<div class="accordion" id="accordion-mac">
<accordion parent="accordion-mac" heading="===MacOS===">


#Download the Mac installer for the latest official Ardor Client {{NRSVersion}} from {{NRSMacInstaller}}. After downloading, [[Faq#How_to_verify_authenticity_of_Ardor_installations|verify its signature]]. After downloading, check the SHA256 hash of the package for security. If you want to test the latest testnet-only version {{NRSVersionExperimental}} that includes the snapshotting and pruning functionality, refer to the Universal Zip Package.
#Open the MacOS terminal.
#Navigate to the Mac installer you just have downloaded.
#Execute the command <code>sudo xattr -c ardor-installer-{{NRSVersion}}.dmg</code>. Type your passphrase
#Run the installer package (Ardor's Mac installer comes packaged in .dmg format) and follow the instructions on screen
## Select the language [[File:MacInstaller_2.png|none|border|400px]]
## Click on 'Next' to begin with the installation [[File:MacInstaller_3.png|none|border|400px]]
## Accept the terms of the license agreement [[File:MacInstaller_4.png|none|border|400px]]
## Select the installation path [[File:MacInstaller_5.png|none|border|400px]]
## Select the packages you want to install [[File:MacInstaller_6.png|none|border|400px]]
## Check the options [[Tutorial_on_setting_up_the_ardor_testnet|See the tutorial for setting up the Ardor testnet]] [[File:MacInstaller_7.png|none|border|400px]]
## Once installed, click on finish [[File:MacInstaller_9.png|none|border|400px]]
#You can now run the Ardor software clicking on the "ardor.app" in Applications. If you already have created a Ardor account, click in 'Returning User' to introduce your passphrase. If you need to create your Ardor account, [[How_to_create_an_account_on_the_Ardor_Platform|click here for instructions to Create a New Ardor Account]].
</accordion>
</div>


<div class="accordion" id="accordion-linux">
<accordion parent="accordion-linux" heading="===Linux===">


Here is the guide to installing the Ardor Client on a Linux 64-bit platform. 32-bit installation instructions are very similar; you just might need to download the 32-bit version of Java instead of the 64-bit one.


You can use these instructions on your Linux VPS as well.

====Set up Java==== 
You can skip this step if you already have Java installed. Otherwise, you can install it via your distribution repository doing the following (for Ubuntu/Debian builds):


<pre>sudo apt update
sudo apt install openjdk-11-jre-headless</pre>


You can also use `openjdk-8-jre-headless` or any other Java 8+ compatible version.

====Install and run the Ardor Client==== 

=====Using the Unix installer===== 
You can execute the Unix installer executable compatible with most Linux distributions from [https://www.jelurida.com/ardor-client.sh ardor-client.sh] and follow the instructions.


<pre>wget https://www.jelurida.com/ardor-client.sh
sh ardor-client.sh
</pre>

=====Using the Universal Zip Package===== 
You can follow the more generic instructions as explained below:
#Change to your home folder and download the latest client (version {{NRSVersion}} or the experimental {{NRSVersionExperimental}}):<br /><code>cd ~</code><br /><code>wget {{NRSDownload}}</code><code>wget https://www.jelurida.com/ardor-client.zip.asc</code> and verify that the signature is correct: <code>gpg --with-fingerprint ardor-client.zip.asc</code>
#Unzip it:<br /><code>unzip ardor-client.zip</code><br /><code>cd ardor</code>

Using the experimental version is as follows:

<br /><code>cd ~</code><br /><code>wget {{NRSExperimentalDownload}}</code><code>wget https://www.jelurida.com/ardor-client-experimental.zip.asc</code> and verify that the signature is correct: <code>gpg --with-fingerprint ardor-client-experimental.zip.asc</code>

=====Run the Ardor client===== 


#Now it's time to start the software. You may start it by executing <code>./run.sh</code> or <code>./run.sh --daemon</code> for running the Ardor node in the background, which you will find in the ardor directory. The server will be active as soon as you see in the window a text similar to this: <br/><code>Ardor server {{NRSVersion}} started successfully.</code> This shell window will be running the Ardor server and print all the Ardor log messages, so it needs to stay running!<br />
#Open http://localhost:27876/ from a web browser to access the Ardor Client. Please note that, if it's the first time you run Ardor in your machine, the Ardor blockchain will need to be downloaded until it is up to date. Depending on your network connection speed, this may take a few hours. The Ardor Client will show you a progress bar as the blockchain downloads. Now you can visit the [[How_to_create_an_account_on_the_Ardor_Platform|click here for instructions to Create a New Ardor Account]].
#*NOTE: If you've installed the client on a dedicated server or VPS, you should change "localhost" to your Server/VPS IP.
</accordion>
</div>


<div class="accordion" id="accordion-pi">
<accordion parent="accordion-pi" heading="===Raspberry Pi===">


For installing the Ardor client on a Raspberry pi, you can refer to the description of [https://medium.com/@mrv_89306/solar-powered-ardor-blockchain-node-aa680a976c50 an implementation with the Ardor client powered by solar panels]
</accordion>
</div>


<div class="accordion" id="accordion-android">
<accordion parent="accordion-android" heading="===Android===">
Click on the [[Android_Full_Node|Android Full Node installation guide]] and follow the instructions.
</accordion>
</div>

<div class="accordion" id="accordion-docker">
<accordion parent="accordion-docker" heading="===Docker Image===">
There is an Ardor Node Docker image available in the Docker Hub: [https://hub.docker.com/r/jeluridaswiss/ardor Ardor Docker Image]. Deploying this image requires knowledge about docker and management of containers. Please refer to the tutorial [[Deploying_the_Ardor_Node_Docker_Image|Deploying the Ardor Node Docker Image]]
</accordion>
</div>

==='''Need help?'''=== 
Need help during the download or development process? Contact us on the [https://talk.jelurida.com Ardor & Nxt Technical forum], and take a look at the [[Faq|FAQ]]. You can also reach us by opening a ticket in our [https://desk.zoho.eu/portal/jelurida/home helpdesk]

==Lightweight Contracts documentation== 
Lightweight Contracts represent a framework for developing a layer of automation on top of the existing Ardor APIs, refer to the official documentation to read more about this feature:


<div class="noprint" style="float:none; border:1px solid black;width:95%;background-color:#F6F0F0;padding:2px;">
{| cellspacing="0"
| style="padding-left:50px;"| '''[[Lightweight_Contracts|Lightweight Contracts documentation]]'''
|}</div>
<noinclude>

==Login to Ardor== 
There are different ways to log in to Ardor to create an account. It is explained in the [[Login_Page_Tutorial|Login Page Tutorial]]

==Getting your first ARDR== 


With the Ardor client installed, it is now time to start transacting. To do that, we need to get some tokens, be it ARDR, IGNIS, or any other child chain. The Ardor mainnet is live and actual tokens are in circulation across numerous major exchanges.


Note the tokens we will be using in the next examples are from testnet. These tokens are not traded in exchanges and have no monetary value -- they exist only as a convenience for developers and those willing to experiment with the features.


The process for receiving testnet tokens is simple. Ask for them in the [https://ardorforum.org Ardor Forum], contact us on the [https://ardornxt.slack.com slack] channel #helpdesk. There is an external [https://www.ardor.world/faucet_ardor/ faucet] as well.

=== Exchanges === 


* [https://www.jelurida.com/ardor/explorers Currently trading ARDR]

==Next steps== 


Learn how to use the Ardor platform by following the [[Basic_tutorials|basic tutorials]] or start reading about Ardor's extensive built-in [[Features]].

=== Staking === 


The process of staking in Ardor is called [[Forging_(f)|Forging]]. Once you have more than 1.000 ARDR you can start forging, thus earning the transaction fees when a block is generated by your node.


Furthermore, you can also opt-in the [[Node_Reward_Program|Node Reward Program]] by just setting up a node with both the API and peer ports open to the Internet and a public and static IP address.

==Feedback and errors== 


If an error in this documentation is found, we would love to be aware to correct it as soon as possible. Please write a question to [mailto:info@jelurida.com info@jelurida.com] and we will take care.


<accordion parent="accordion" heading="Latest documentation changes and updates">
{{Special:SimpleChanges/days=150,limit=100,bots,hideminor,namespace=0}}
</accordion>
</translate>

Getting started - Revision history

Petko: Removed link to https://www.ardor.world/faucet_ardor/ and substituted the link to https://ardorforum.org/ with https://talk.jelurida.com/t/ardor-tesnet-tokens/1325

Admin: instructions for use of zip file on MacOS

Almonte at 22:41, 7 June 2022