rename palladium-node-data to .palladium to follow Unix standards

Rename the data directory from palladium-node-data/ to .palladium/
to align with Unix convention for application data directories.
This change makes the directory hidden by default and follows the
standard naming pattern used by blockchain nodes
This commit is contained in:
2026-02-11 12:29:16 +01:00
parent b27f0b5778
commit 8131d7048e
6 changed files with 41 additions and 42 deletions

View File

@@ -16,7 +16,7 @@ docker-compose.yml
# Data and runtime files # Data and runtime files
electrumx-data/ electrumx-data/
palladium-node-data/ .palladium/
*.log *.log
*.pid *.pid

4
.gitignore vendored
View File

@@ -2,8 +2,8 @@
/electrumx-data/ /electrumx-data/
# Palladium node data (keep only the config file) # Palladium node data (keep only the config file)
/palladium-node-data/* /.palladium/*
!/palladium-node-data/palladium.conf !/.palladium/palladium.conf
# Logs # Logs
*.log *.log

View File

@@ -6,7 +6,7 @@ Everything runs in Docker containers - no need to install dependencies on your h
--- ---
## 📦 What You Get ## What You Get
- **Palladium Full Node** (palladiumd) - Runs in Docker with full blockchain sync - **Palladium Full Node** (palladiumd) - Runs in Docker with full blockchain sync
- **ElectrumX Server** - Pre-configured for Palladium network with automatic indexing - **ElectrumX Server** - Pre-configured for Palladium network with automatic indexing
@@ -17,7 +17,7 @@ Everything runs in Docker containers - no need to install dependencies on your h
--- ---
## 🖥️ Tested Platforms ## Tested Platforms
* Debian 12/13 * Debian 12/13
* Ubuntu 24.04/22.04 LTS * Ubuntu 24.04/22.04 LTS
@@ -32,7 +32,7 @@ Everything runs in Docker containers - no need to install dependencies on your h
--- ---
## 📋 Project Structure ## Project Structure
``` ```
plm-electrumx/ plm-electrumx/
@@ -41,7 +41,7 @@ plm-electrumx/
│ ├── palladium-cli # CLI tool (required) │ ├── palladium-cli # CLI tool (required)
│ ├── palladium-tx # Transaction tool (optional) │ ├── palladium-tx # Transaction tool (optional)
│ └── palladium-wallet # Wallet tool (optional) │ └── palladium-wallet # Wallet tool (optional)
├── palladium-node-data/ ├── .palladium/
│ ├── palladium.conf # Node configuration (edit this!) │ ├── palladium.conf # Node configuration (edit this!)
│ ├── blocks/ # Blockchain blocks (auto-generated) │ ├── blocks/ # Blockchain blocks (auto-generated)
│ ├── chainstate/ # Blockchain state (auto-generated) │ ├── chainstate/ # Blockchain state (auto-generated)
@@ -61,7 +61,7 @@ plm-electrumx/
--- ---
## 🏗️ Architecture ## Architecture
``` ```
Internet Router/Firewall Docker Network Internet Router/Firewall Docker Network
@@ -75,25 +75,25 @@ Internet Router/Firewall Docker Network
│ └────────────┘ ││ │ │ │ │ └────────────┘ ││ │ │ │
│ ││ │ │ │ │ ││ │ │ │
│ ┌─────────▼▼─▼─────▼─────┐ │ │ ┌─────────▼▼─▼─────▼─────┐ │
│ │ Docker Host │ │ │ │ Docker Host │ │
│ │ │ │ │ │ │ │
│ │ ┌───────────────────┐ │ │ │ │ ┌───────────────────┐ │ │
│ │ │ Palladium Node │ │ │ │ │ │ Palladium Node │ │ │
│ │ │ (palladiumd) │ │ │ │ │ │ (palladiumd) │ │ │
│ │ │ Port: 2333 │ │ │ │ │ │ Port: 2333 │ │ │
│ │ └────────┬──────────┘ │ │ │ │ └────────┬──────────┘ │ │
│ │ │ │ │ │ │ │ │ │
│ │ ┌────────▼──────────┐ │ │ │ │ ┌────────▼──────────┐ │ │
│ │ │ ElectrumX Server │ │ │ │ │ │ ElectrumX Server │ │ │
Clients◄───────────────────────┤ TCP: 50001 │ │ │ Clients◄───────────────────────┤ TCP: 50001 │ │ │
(Electrum │ │ SSL: 50002 │ │ │ (Electrum │ │ SSL: 50002 │ │ │
Wallets) │ └────────┬──────────┘ │ │ Wallets) │ └────────┬──────────┘ │ │
│ │ │ │ │ │ │ │ │ │
│ │ ┌────────▼─────────┐ │ │ │ │ ┌────────▼─────────┐ │ │
▼ │ │ Web Dashboard │ │ │ ▼ │ │ Web Dashboard │ │ │
Browser◄───────────────────────┤ Port: 8080 │ │ │ Browser◄───────────────────────┤ Port: 8080 │ │ │
│ └──────────────────┘ │ │ │ └──────────────────┘ │ │
────────────────────────┘ │ └────────────────────────┘ │
``` ```
**Component Communication:** **Component Communication:**
@@ -105,7 +105,7 @@ Browser◄───────────────────────
--- ---
## 🔧 Requirements ## Requirements
* [Docker](https://docs.docker.com/get-docker/) 20.10+ * [Docker](https://docs.docker.com/get-docker/) 20.10+
* [Docker Compose](https://docs.docker.com/compose/install/) 2.0+ * [Docker Compose](https://docs.docker.com/compose/install/) 2.0+
@@ -113,7 +113,7 @@ Browser◄───────────────────────
--- ---
## 🚀 Quick Start Guide ## Quick Start Guide
### Step 1: Clone the Repository ### Step 1: Clone the Repository
@@ -161,7 +161,7 @@ ls -lh daemon/
Open the configuration file: Open the configuration file:
```bash ```bash
nano palladium-node-data/palladium.conf nano .palladium/palladium.conf
``` ```
**Change these credentials:** **Change these credentials:**
@@ -252,9 +252,9 @@ For your ElectrumX server to be accessible from the internet, you **must** confi
If you have a synced Palladium blockchain, copy it to speed up initial sync: If you have a synced Palladium blockchain, copy it to speed up initial sync:
```bash ```bash
cp -r ~/.palladium/blocks palladium-node-data/ cp -r ~/.palladium/blocks .palladium/
cp -r ~/.palladium/chainstate palladium-node-data/ cp -r ~/.palladium/chainstate .palladium/
cp -r ~/.palladium/indexes palladium-node-data/ cp -r ~/.palladium/indexes .palladium/
``` ```
**Skip this** if syncing from scratch - the node will automatically start syncing. **Skip this** if syncing from scratch - the node will automatically start syncing.
@@ -422,7 +422,7 @@ python test-server.py <your-public-ip>:50002
### Palladium Node Settings ### Palladium Node Settings
Key settings in `palladium-node-data/palladium.conf`: Key settings in `.palladium/palladium.conf`:
| Setting | Value | Purpose | | Setting | Value | Purpose |
|---------|-------|---------| |---------|-------|---------|
@@ -725,8 +725,8 @@ environment:
## Notes ## Notes
* **Data Persistence:** All data stored in `./palladium-node-data/` and `./electrumx-data/` * **Data Persistence:** All data stored in `./.palladium/` and `./electrumx-data/`
* **Backup:** Regularly backup `palladium-node-data/wallet.dat` if you store funds * **Backup:** Regularly backup `.palladium/wallet.dat` if you store funds
* **Network Switch:** Always clear ElectrumX database when switching networks * **Network Switch:** Always clear ElectrumX database when switching networks
* **Updates:** Check for Palladium Core updates regularly * **Updates:** Check for Palladium Core updates regularly
@@ -738,7 +738,7 @@ Distributed under the **MIT** license. See `LICENSE` file for details.
--- ---
## 🆘 Support ## Support
- **Issues:** [GitHub Issues](https://github.com/palladium-coin/plm-electrumx/issues) - **Issues:** [GitHub Issues](https://github.com/palladium-coin/plm-electrumx/issues)
- **Palladium Community:** [Palladium Coin](https://github.com/palladium-coin) - **Palladium Community:** [Palladium Coin](https://github.com/palladium-coin)
@@ -749,4 +749,3 @@ Distributed under the **MIT** license. See `LICENSE` file for details.
## Credits ## Credits
- **ElectrumX:** [kyuupichan/electrumx](https://github.com/kyuupichan/electrumx) - **ElectrumX:** [kyuupichan/electrumx](https://github.com/kyuupichan/electrumx)
- **Palladium Core:** [palladium-coin/palladiumcore](https://github.com/palladium-coin/palladiumcore)

View File

@@ -15,8 +15,8 @@ services:
# For testnet, expose: 12332 (RPC) and 12333 (P2P) # For testnet, expose: 12332 (RPC) and 12333 (P2P)
volumes: volumes:
# Mount palladium-node-data folder (contains config and blockchain data) # Mount .palladium folder (contains config and blockchain data)
- ./palladium-node-data:/root/.palladium - ./.palladium:/root/.palladium
command: > command: >
palladiumd palladiumd
@@ -70,7 +70,7 @@ services:
volumes: volumes:
- ./electrumx-data:/data - ./electrumx-data:/data
- ./palladium-node-data/palladium.conf:/palladium-config/palladium.conf:ro - ./.palladium/palladium.conf:/palladium-config/palladium.conf:ro
dashboard: dashboard:
build: build:
@@ -92,5 +92,5 @@ services:
ELECTRUMX_RPC_PORT: "8000" ELECTRUMX_RPC_PORT: "8000"
volumes: volumes:
- ./palladium-node-data/palladium.conf:/palladium-config/palladium.conf:ro - ./.palladium/palladium.conf:/palladium-config/palladium.conf:ro
- /var/run/docker.sock:/var/run/docker.sock:ro - /var/run/docker.sock:/var/run/docker.sock:ro

View File

@@ -13,7 +13,7 @@ get_conf_value() {
# Check if palladium.conf exists # Check if palladium.conf exists
if [ ! -f "$PALLADIUM_CONF" ]; then if [ ! -f "$PALLADIUM_CONF" ]; then
echo "ERROR: palladium.conf not found at $PALLADIUM_CONF" echo "ERROR: palladium.conf not found at $PALLADIUM_CONF"
echo "Please ensure the palladium-node-data volume is mounted correctly." echo "Please ensure the .palladium volume is mounted correctly."
exit 1 exit 1
fi fi