Skip to main content

Installation Guide

This guide will walk you through installing and setting up the NuNet device management service.

Prerequisites​

  • Go 1.21 or later
  • Docker (for containerized workloads)
  • Git
  • Network connectivity

Installation Methods​

  1. Download the latest release from GitHub
  2. Extract the binary to your PATH
  3. Verify installation:
nunet-dms --version

Method 2: Build from Source​

  1. Clone the repository:
git clone https://gitlab.com/nunet/device-management-service.git
cd device-management-service
  1. Build the project:
make build
  1. Install the binary:
sudo make install

Method 3: Docker​

docker pull nunet/dms:latest
docker run -d --name nunet-dms nunet/dms:latest

Configuration​

Initial Setup​

  1. Initialize configuration:
nunet-dms init
  1. Configure your device:
nunet-dms config set device.name "My Device"
nunet-dms config set device.cpu.cores 8
nunet-dms config set device.memory.gb 16

Network Configuration​

Configure your network settings:

nunet-dms config set network.port 8080
nunet-dms config set network.public-ip "your-public-ip"

Storage Configuration​

Set up storage for jobs and data:

nunet-dms config set storage.path "/var/lib/nunet"
nunet-dms config set storage.size.gb 100

Verification​

Test your installation:

# Check device status
nunet-dms status

# Run a test job
nunet-dms run --image hello-world

# View logs
nunet-dms logs

Troubleshooting​

Common Issues​

  1. Port already in use: Change the port in configuration
  2. Permission denied: Ensure proper file permissions
  3. Network connectivity: Check firewall settings

Getting Help​

Next Steps​