Integrationnet - Build a Pacaswap node

System Requirements

To run a Metagraph Validator Node, ensure your machine meets the following minimum requirements:

• Memory (RAM):

  • Minimum: 8 GB

  • Recommended: 16 GB or more for optimal performance

• Storage:

  • At least 100 GiB of SSD storage

• CPU:

  • Minimum: 2 vCPU

  • Recommended: 4 vCPU

Dependencies

This node runs inside a Docker container, so you’ll need the following installed on your local machine or cloud instance:

Docker Engine

Ensure Docker is installed and running. Installation instructions can be found in the official documentation:

👉 Docker Engine Install Guide

Docker Compose

Docker Compose is required to manage multi-container setups. You can install it by following this guide:

👉 Docker Compose Install Guide

Java

Java is required to run the JARs. You can install it by following this guide:

👉 Java Install Guide

.p12 File and Node ID

Before proceeding, you need to create a .p12 file and get your Node ID so we can add you to the seed list.

1.1 Download the required tools

Download the following files from the latest Tessellation release:

• cl-keytool.jar

• cl-wallet.jar

🔗 You’ll find them under Assets here: 👉 Tessellation Releases on GitHub

1.2 Set your environment variables

export CL_KEYSTORE="my_node.p12"
export CL_KEYALIAS="my_node"
export CL_PASSWORD="your_secure_password"

1.3 Generate your .p12 file

java -jar cl-keytool.jar generate

1.4 Get your Node ID

java -jar cl-wallet.jar show-id

1.5 Share your Node ID

Tag the team on Discord and send your Node ID so it can be added to the seed list.

⚠️ Only proceed to the next step after your Node ID has been confirmed in the seed list.

Full instructions

👉 Working with .p12 files

Installation

To install and run a Metagraph validator node, follow the steps below:

1. Create your working directory

mkdir my-node
cd my-node

2. Create the shared-data directory with the metagraph-l0 subdirectory

mkdir -p shared-data/metagraph-l0

3. Copy your .p12 keystore file into this directory

If you haven’t created a .p12 file yet, follow the official guide: Working with .p12 files

cp /path/to/your/file.p12 shared-data/metagraph-l0/

4. Return to the root of your my-node directory Ensure you’re back in my-node before the next steps:

cd my-node

5. Create a docker-compose.yml file

Use the appropriate template for your network (e.g. docker-compose.integrationnet.yml) and paste it into a new file:

nano docker-compose.yml

5KB

docker-compose-integrationnet.yml

6. Create a .env file Use the corresponding .env template (e.g. .env.integrationnet) and paste it into a new file:

nano .env

3KB

.env.integrationnet

7. Edit the .env file with your node’s configuration

Make sure to update the following values:

• NODE_IP: Your instance’s public IP

• METAGRAPH_L0_CL_KEYSTORE: Full path to your .p12 file (e.g. /app/shared-data/metagraph-l0/my_file.p12)

• METAGRAPH_L0_CL_KEYALIAS: Your keystore alias (e.g. my_file)

• METAGRAPH_L0_CL_PASSWORD: Your keystore password (e.g. my_password)

8. Verify your folder structure

Your my-node directory should now contain:

my-node/
├── docker-compose.yml
├── .env
└── shared-data/
    └── metagraph-l0/
        └── your_file.p12

9. Start your node 🚀 Run the following command to bring your node up:

docker-compose down && docker-compose pull && docker-compose up -d && docker-compose logs -f

This command will:

• Stop any running container

• Pull the latest image

• Start the node in detached mode

• Stream the logs