Binary

In this guide, we will use the binary provided in Uomi release.

If you have experience with Rust compilation, you can also build the binary from the repo.

Installing an Archive Node

System Requirements

⚠️ Minimum Hardware Requirements

• RAM: 16GB

• Storage: 500GB

• CPU: 8 cores

• Good network connectivity

Prerequisites

Before starting the installation, ensure you have:

• Ubuntu 20.04 LTS or higher

• Root or sudo privileges

• The following packages installed:

  sudo apt-get update
  sudo apt-get install -y \
      curl \
      jq \
      build-essential \
      libssl-dev \
      pkg-config \
      cmake \
      git \
      libclang-dev

Installation Steps

1. Prepare the Environment

Create necessary directories and user:

# Create service user
sudo useradd --no-create-home --shell /usr/sbin/nologin uomi

# Create node directory
sudo mkdir -p /var/lib/uomi
sudo chown -R uomi:uomi /var/lib/uomi

2. Install Binary Files

# Copy binary to system path
sudo cp ./uomi /usr/local/bin/
sudo chmod +x /usr/local/bin/uomi

# Copy genesis file
sudo cp ./genesis.json /usr/local/bin/

3. Create Service File

Create a systemd service file at /etc/systemd/system/uomi.service:

[Unit]
Description=Uomi Node
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
User=uomi
Group=uomi
Restart=always
RestartSec=10
LimitNOFILE=65535
ExecStart=/usr/local/bin/uomi \
    --name "your-archive-node-name" \
    --chain "/usr/local/bin/genesis.json" \
    --base-path "/var/lib/uomi" \
    --pruning archive \
    --rpc-cors all \
    --rpc-external \
    --rpc-methods Safe \
    --enable-evm-rpc \
    --prometheus-external

# Hardening
ProtectSystem=strict
PrivateTmp=true
PrivateDevices=true
NoNewPrivileges=true
ReadWritePaths=/var/lib/uomi

[Install]
WantedBy=multi-user.target

4. Start the Node

# Reload systemd
sudo systemctl daemon-reload

# Enable service
sudo systemctl enable uomi.service

# Start service
sudo systemctl start uomi.service

5. Monitor the Node

Check node status:

sudo systemctl status uomi.service

View logs:

tail -f /var/log/uomi.log

Verifying Installation

You can verify your node is running correctly by:

1. Checking the service status:

sudo systemctl status uomi.service

1. Verifying RPC endpoint:

curl -H "Content-Type: application/json" \
    -d '{"id":1, "jsonrpc":"2.0", "method": "system_health", "params":[]}' \
    http://localhost:9944

Common Issues

🔧 Troubleshooting

1. Service Won't Start

   • Check logs: journalctl -u uomi.service -f

   • Verify file permissions

   • Ensure ports are not in use

2. Sync Issues

   • Verify network connectivity

   • Check disk space

   • Ensure sufficient RAM

Maintenance

Updating the Node

1. Stop the service:

sudo systemctl stop uomi.service

1. Replace the binary:

sudo cp ./new-uomi /usr/local/bin/uomi
sudo chmod +x /usr/local/bin/uomi

1. Restart the service:

sudo systemctl start uomi.service

Backup

Regularly backup your node data:

sudo tar -czf uomi-backup-$(date +%Y%m%d).tar.gz /var/lib/uomi

Security Recommendations

1. Firewall Configuration

sudo ufw allow 9944/tcp  # RPC
sudo ufw allow 30333/tcp # P2P

1. Regular Updates

• Keep the system updated

• Monitor security announcements

• Update the node software when new versions are released

Stay Connected

Join our Discord community to:

• Get the latest updates about node operations

• Connect with other node operators

• Receive technical support

• Participate in community discussions

💬 Join Our Community Join the UOMI Discord server