Native Linux Microcontainers

Joblet is a micro-container runtime for running Linux jobs with: Process and filesystem isolation (PID namespace, chroot) Fine-grained CPU, memory, and IO throttling (cgroups v2) Secure job execution with mTLS and RBAC Built-in scheduler, SSE log streaming, and multi-core pinning Ideal for: Agentic AI Workloads (Untrusted code)

Project maintained by ehsaniara Hosted on GitHub Pages — Theme by mattgraham

Joblet Web Admin UI

The Joblet Web Admin UI provides a comprehensive React-based interface for managing jobs, monitoring system performance, and visualizing workflows. The admin UI is now available as a standalone package in the joblet-admin repository, connecting directly to the Joblet server via gRPC.

Table of Contents

Installation

Prerequisites

Standalone Installation

The Admin UI is now available as a separate package from the joblet-admin repository:

# Clone the joblet-admin repository
git clone https://github.com/ehsaniara/joblet-admin
cd joblet-admin

# Install dependencies
npm install

# Start the admin interface
npm run dev

# Access at http://localhost:3000

Note: The admin UI connects directly to the Joblet server via gRPC.

Production Installation

# Build the application
npm run build

# Start in production mode
npm start

# Or deploy the built files from dist/ directory

Getting Started

Launch the Admin UI

# Development mode (recommended)
npm run dev
# UI: http://localhost:3000
# API: http://localhost:5175

# Production mode
npm run build
npm start

# Development with custom ports
JOBLET_ADMIN_PORT=8080 npm run dev:server

The admin UI will be available at http://localhost:3000 by default.

First Login

  1. Ensure your Joblet server is running and accessible
  2. The admin UI automatically uses your RNX configuration for authentication
  3. No separate login is required - mTLS certificates handle authentication

Dashboard Overview

The admin UI consists of several main sections accessible via the navigation sidebar:

🏠 Dashboard

📊 System Monitoring

💼 Jobs

🔄 Workflows

⚙️ Administration

System Monitoring

The System Monitoring page provides comprehensive real-time insights into your Joblet server performance.

System Monitoring Overview Real-time system metrics and performance monitoring dashboard

Host Information Card

Displays essential server information:

CPU Details Card

Real-time CPU monitoring:

Memory Details Card

Comprehensive memory monitoring:

Disk Information Card

Storage monitoring across all mount points:

Network Interfaces Card

Network monitoring for all interfaces:

Process Monitor Card

Real-time process monitoring:

Interactive Features

System Monitoring Detailed View Detailed system metrics with CPU, memory, and process monitoring

Job Management

Job List View

The Jobs page provides a comprehensive overview of all job executions:

Features

Job Information Displayed

Column Description
Job ID Unique identifier for the job
Status Current execution status (running, completed, failed, etc.)
Command The command or script being executed
Runtime Runtime environment (if specified)
Network Network configuration
Started Job start timestamp
Duration Execution time (for completed jobs)
Actions Quick action buttons (stop, logs, delete)

Job Status Indicators

Job Details View

Click on any job ID to view detailed information:

Job Information

Real-time Logs

Job Actions

Advanced Filtering

Filter jobs by various criteria:

Workflow Management

The Workflows section provides powerful tools for managing complex job orchestrations.

Workflow Management Interface Workflow visualization and management interface with dependency graph

Workflow List View

Overview Display

Workflow Information

Workflow Detail Views

Click on any workflow to access detailed visualization options:

Graph View

Tree View

Timeline View

Workflow Execution

Starting Workflows

Monitoring Execution

Workflow Actions

Administration Features

Volume Management

Create and manage persistent storage volumes:

Volume Operations

Volume Information

Network Configuration

Manage custom networks for job isolation:

Network Features

Network Monitoring

Runtime Management

Monitor and manage runtime environments:

Runtime Information

Runtime Actions

System Configuration

User Preferences

Server Configuration

Troubleshooting

Common Issues

Admin UI Won’t Start

# Check if ports are already in use
lsof -i :3000  # UI port
lsof -i :5175  # API port

# Try different ports
JOBLET_ADMIN_PORT=8080 npm run dev:server
PORT=8081 npm run dev:ui

# Check Node.js installation
node --version
npm --version

Connection Issues

# Verify server connectivity
rnx job list

# Check configuration
cat ~/.rnx/rnx-config.yml

# Test server connection
rnx monitor status

# Check admin server logs
npm run dev:server
# Look for gRPC connection errors

Performance Issues

Logs and Debugging

Admin UI Logs

# View admin server logs
npm run dev:server
# Server logs will show gRPC connection status

# View UI development logs
npm run dev:ui
# React development server logs

# Check browser console
# Open browser developer tools (F12)
# Look for JavaScript errors in console

Server-side Logs

# Check Joblet server logs
sudo journalctl -u joblet -f

# Check system resources
rnx monitor status

Getting Help

Feature Requests

The admin UI is actively developed. To request new features:

  1. Check existing GitHub issues
  2. Create a new feature request with detailed description
  3. Include use cases and expected behavior
  4. Add mockups or wireframes if applicable

Security Considerations

Authentication

Network Security

Data Protection

For more information, see the main documentation or visit the GitHub repository.