Storage KV

﻿
0G Storage KV is a key-value store built on top of the 0G Storage system. This guide provides detailed steps to deploy and run a 0G Storage KV node.
🖥️ Hardware Requirements
Component
Storage KV
Memory
32 GB RAM
CPU
8 cores
Disk
Size matches the KV streams it maintains
Bandwidth
-
🛞 Auto installer 
⌨️
source <(curl -s https://raw.githubusercontent.com/zstake-xyz/test/refs/heads/main/0g_kv_install.sh) # kv install
source <(curl -s https://raw.githubusercontent.com/zstake-xyz/test/refs/heads/main/0g_kv_install.sh) # kv install
﻿
🛰️ Auto Version Update 
 ⌨️
source <(curl -s https://raw.githubusercontent.com/zstake-xyz/test/refs/heads/main/0g_kv_update.sh) # kv update
source <(curl -s https://raw.githubusercontent.com/zstake-xyz/test/refs/heads/main/0g_kv_update.sh) # kv update
﻿
﻿
🕹️ Manual installer 
1. Install necessary packages
⌨️
sudo apt update && sudo apt upgrade -y
sudo apt update && sudo apt upgrade -y
﻿
2. Clone the 0g-storage-kv repository from GitHub
⌨️
git clone -b v1.4.0 https://github.com/0glabs/0g-storage-kv.git
git clone -b v1.4.0 https://github.com/0glabs/0g-storage-kv.git
﻿
4. Build the project in release mode
⌨️
cd $HOME/0g-storage-kv
git stash
git fetch --all --tags
git checkout 1e7c207 
git submodule update --init
cargo build --release
cd $HOME/0g-storage-kv
git stash
git fetch --all --tags
git checkout 1e7c207 
git submodule update --init
cargo build --release
﻿
5. Edit the configuration file
⌨️
rm -rf $HOME/0g-storage-kv/run/config.toml
curl -o $HOME/0g-storage-kv/run/config.toml https://raw.githubusercontent.com/zstake-xyz/test/main/0g_kv_config.toml
rm -rf $HOME/0g-storage-kv/run/config.toml
curl -o $HOME/0g-storage-kv/run/config.toml https://raw.githubusercontent.com/zstake-xyz/test/main/0g_kv_config.toml
﻿
6. Create a systemd service file
⌨️
sudo tee /etc/systemd/system/0gkv.service > /dev/null <<EOF
[Unit]
Description=0G-KV Node
After=network.target

[Service]
User=root
WorkingDirectory=$HOME/0g-storage-kv/run
ExecStart=$HOME/0g-storage-kv/target/release/zgs_kv --config $HOME/0g-storage-kv/run/config.toml
Restart=always
RestartSec=10
LimitNOFILE=65535
StandardOutput=journal
StandardError=journal
SyslogIdentifier=zgs_kv

[Install]
WantedBy=multi-user.target
EOF
sudo tee /etc/systemd/system/0gkv.service > /dev/null <<EOF
[Unit]
Description=0G-KV Node
After=network.target

[Service]
User=root
WorkingDirectory=$HOME/0g-storage-kv/run
ExecStart=$HOME/0g-storage-kv/target/release/zgs_kv --config $HOME/0g-storage-kv/run/config.toml
Restart=always
RestartSec=10
LimitNOFILE=65535
StandardOutput=journal
StandardError=journal
SyslogIdentifier=zgs_kv

[Install]
WantedBy=multi-user.target
EOF
﻿
7. Start the service immediately
⌨️
sudo systemctl daemon-reload && sudo systemctl enable 0gkv && sudo systemctl start 0gkv
sudo systemctl daemon-reload && sudo systemctl enable 0gkv && sudo systemctl start 0gkv
﻿
⌨️ Useful Commands
8. Log Check
⌨️
sudo journalctl -u 0gkv -f -o cat
sudo journalctl -u 0gkv -f -o cat
﻿
스크린샷 2024-08-27 오후 8.49.42.png
﻿
﻿