Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ taxonomy:
- 'PIVX Core Wallet'
author:
- 'The PIVX Team'
sitemap:
lastmod: '11-01-2025 14:12'
autoseo:
enabled: true
---

### System Requirements
Expand All @@ -26,20 +30,28 @@ The installation method differs based on the operating system being used.

[tabs]
[tab title="Linux"]
1. Navigate to the folder where you want to install the PIVX Core Wallet (for example `cd /home/pivx`)
2. Download the latest version of the Core Wallet:
* Intel/AMD: `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-x86_64-linux-gnu.tar.gz`
* ARM: `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-arm-linux-gnueabihf.tar.gz`
3. Unzip the archive:
* Intel.AMD: `tar -zxvf pivx-[version]-aarch64-linux-gnu.tar.gz && sudo rm -f pivx-[version]-x86_64-linux-gnu.tar.gz`
* ARM: `tar -zxvf pivx-[version]-arm-linux-gnueabihf.tar.gz && sudo rm -f pivx-[version]-arm-linux-gnueabihf.tar.gz`
4. Navigate to the newly created folder `cd pivx-[version]`
5. **First install only:** Install the Sapling parameters by running the command `./install-params.sh`

1. Open a terminal and navigate to the folder where you want to install the PIVX Core Wallet
* For most people, the users home folder `cd ~`
3. Download and unzip the latest version of the PIVX Core Wallet:
* **Intel/AMD 64 Bit**
1. `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-x86_64-linux-gnu.tar.gz`
2. `tar -zxvf pivx-[version]-x86_64-linux-gnu.tar.gz && sudo rm -f pivx-[version]-x86_64-linux-gnu.tar.gz`
* **Intel/AMD 64 Bit**
1. `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-i686-pc-linux-gnu.tar.gz`
2. `tar -zxvf pivx-[version]-i686-pc-linux-gnu.tar.gz && sudo rm -f pivx-[version]-i686-pc-linux-gnu.tar.gz`
* **ARM 64 Bit**
1. `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-aarch64-linux-gnu.tar.gz`
2. `tar -zxvf pivx-[version]-aarch64-linux-gnu.tar.gz && sudo rm -f pivx-[version]-aarch64-linux-gnu.tar.gz`
* **ARM 32 Bit**
1. `wget https://github.com/PIVX-Project/PIVX/releases/download/v[version]/pivx-[version]-arm-linux-gnueabihf.tar.gz`
2. `tar -zxvf pivx-[version]-arm-linux-gnueabihf.tar.gz && sudo rm -f pivx-[version]-arm-linux-gnueabihf.tar.gz`
4. Navigate to the newly created folder `cd pivx-[version]`
5. **First install only:** Install the Sapling parameters by running the command `./install-params.sh`
* This step is not required when upgrading the PIVX Core wallet
6. Navigate to the **_bin_** folder: `cd bin` then start the wallet:
* CLI Wallet: `./pivxd -daemon`
* QT Wallet: `./pivx-qt`

* CLI Wallet: `./pivxd -daemon`
* QT Wallet: `./pivx-qt`

[/tab]
[tab title="Windows"]
Expand All @@ -58,19 +70,19 @@ The installation method differs based on the operating system being used.

### Startup / Initial Synchronisation

The first time you run the PIVX Core Wallet, the whole PIVX blockchain will be downloaded locally and verified. This will take approximately 5+/- hours with a fast internet connection, and will require approximately 20GB of space on disk.
The first time you run the PIVX Core Wallet, the entire PIVX blockchain will be downloaded locally and verified. This will take approximately 5+/- hours with a fast internet connection, and will require approximately 20GB of space on disk.

An empty wallet will also be created (stored in a **wallet.dat** file in the PIVX data folder).
An empty wallet will also be created and stored in a **wallet.dat** file located in the [PIVX data folder]( /wallets/pivx-core-wallet/default-data-folder.

### Upgrades

The PIVX Core Wallet is upgraded on a regular basis, in order to deliver new functionalities and fix bugs. There are two main types of releases:
The PIVX Core Wallet is upgraded on a regular basis, in order to deliver new functionalities and bug fixes. There are two main types of releases:
* **Mandatory Releases**: The mandatory releases generally either add functionalities to the wallet or to the network (e.g. cold staking) and/or fix critical issues. They have to be installed by all users before a given date known as the _enforcement date_ which is communicated by the developers at the time the release is published.
* **Recommended/Optional Releases**: Optional releases are recommended for everyone but can generally be skipped safely. They either apply to only a subset of users (e.g. fix impacting masternodes only) or to fix non-critical issues.

!!! **NOTE** - All releases are communicated on the official [PIVX Website](https://pivx.org) and on the **#important-updates** channel of the [PIVX Discord](https://discord.pivx.org) server. It is critical to review them and install all updates before the enforcement block in order to avoid technical issues.
!!! **NOTE** - All new releases are announced on the official [PIVX Website](https://pivx.org) and on the **#important-updates** channel of the [PIVX Discord](https://discord.pivx.org) server. It is critical to review them and install all mandatory updates before the enforcement block in order to avoid technical issues.

The procedure to upgrade the wallet is similar to an installation and is as easy as:
* Shutdown the current version of the wallet.
* Install the new version by following the procedure corresponding to your operating system.
* Restart the core wallet using the newly installed version.
* Restart the core wallet using the newly installed version.
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The **pivxd** process accepts multiple command line options that can be listed (

`pivxd --help`

When no options are specified, the **pivxd** process will use default values for all parameters (such as data folder, log file, etc.), or the ones specified in the pivx.conf file.
When no options are specified, the **pivxd** process will use default values for all parameters (such as [data folder]( /wallets/pivx-core-wallet/default-data-folder), log file, etc.), or the ones specified in the pivx.conf file.

The **pivxd** server logs all of its activities in the `$PIVX_HOME/debug.log` file.

Expand Down
39 changes: 39 additions & 0 deletions 02.wallets/01.pivx-core-wallet/09.data-folder/article.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: 'Wallet Data Folder'
taxonomy:
category:
- 'PIVX Core Wallet'
author:
- 'The PIVX Team'
sitemap:
lastmod: '11-01-2025 15:13'
autoseo:
enabled: true
media_order: pivx-data-folder.png
---

### Default Data Folder

The PIVX Core Wallet stores it's data in a folder that is different from the installation folder. The default location varies based on your operating system.

* **WINDOWS**: `C:\Users\%username%\AppData\Roaming\PIVX`
* **MAC**: `~/Library/Application Support/PIVX` _or_ `~/.pivx`
* **LINUX**: `~/.pivx`

### Custom Data Folder

When installing the QT wallet for the first time, you are presented with a dialog to set the PIVX Core Wallet data folder.

![pivx-data-folder](pivx-data-folder.png?classes=center,img-fluid,py-4 "pivx-data-folder")

If you later decide to change this data folder location, follow these steps:
1. **Close the Wallet**: Ensure that the PIVX wallet is not running.
3. **Create New Folder**: Create a new folder on your computer where you want to store the wallet data.
4. **Copy Wallet Files**: Copy the existing wallet files from the default or current location to the new custom folder.
5. **Delete Old Files**: Delete all the original files except pivx.conf
6. **Edit Configuration**: Edit the pivx.conf file in the original default folder with notepad or text editor adding the following line at the bottom:
* `datadir=xxx` where xxx = complete path to the new data folder
8. **Start Wallet**: Start the PIVX wallet the usual way. It should now be using the custom data folder you specified.

#### Alternative Start Method
* **Add Startup Parameter**: Adjust the wallet startup command to include `-datadir=xxx` parameter, where xxx = complete path to new data folder.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.