Response Examples

{
  "status": "ok",
  "message": "Lightd is running"
}

{
  "ttl": "1h",
  "remove_on_use": false
}

{
  "token": "lightd_f3a8b9c2d1e4f5a6b7c8d9e0f1a2b3c4",
  "expires_at": "2026-01-28T15:30:00Z"
}

{
  "volume_id": "d6764075-c5f1-4045-9fb3-85315b85cb0f",
  "path": "/storage/volumes/d6764075-c5f1-4045-9fb3-85315b85cb0f"
}

{
  "path": "config/server.properties",
  "content": "server-port=25565\nmax-players=20"
}

{
  "message": "File written successfully",
  "path": "config/server.properties"
}

{
  "path": "plugins/MyPlugin"
}

{
  "message": "Folder created successfully",
  "path": "plugins/MyPlugin"
}

{
  "source": "plugins",
  "destination": "backup/plugins"
}

{
  "message": "Copied successfully",
  "source": "plugins",
  "destination": "backup/plugins"
}

{
  "files": [
    {
      "name": "MyPlugin",
      "type": "directory",
      "size": 0
    },
    {
      "name": "config.yml",
      "type": "file",
      "size": 1024
    }
  ]
}

{
  "format": "tar.gz",
  "output_name": "backup"
}

{
  "message": "Compression successful",
  "archive_path": "backup.tar.gz",
  "size": 2048576
}

{
  "archive_path": "backup.tar.gz",
  "destination": "restored"
}

{
  "message": "Decompression successful",
  "destination": "restored"
}

{
  "ip": "0.0.0.0",
  "port": 25565,
  "protocol": "tcp"
}

{
  "message": "Port added to pool",
  "ip": "0.0.0.0",
  "port": 25565,
  "protocol": "tcp"
}

{
  "ip": "0.0.0.0",
  "port": 25565,
  "protocol": "tcp",
  "in_use": false
}

{
  "ports": [
    {
      "ip": "0.0.0.0",
      "port": 25565,
      "protocol": "tcp",
      "in_use": false
    },
    {
      "ip": "0.0.0.0",
      "port": 25566,
      "protocol": "tcp",
      "in_use": true
    },
    {
      "ip": "0.0.0.0",
      "port": 19132,
      "protocol": "udp",
      "in_use": false
    }
  ]
}

{
  "ip": "0.0.0.0",
  "port": 25567,
  "protocol": "tcp",
  "in_use": false
}

{
  "in_use": true
}

{
  "message": "Port usage updated",
  "ip": "0.0.0.0",
  "port": 25565,
  "in_use": true
}

{
  "message": "Port deleted from pool"
}

{
  "ports": [
    {"ip": "0.0.0.0", "port": 25565},
    {"ip": "0.0.0.0", "port": 25566}
  ]
}

{
  "message": "Deleted 2 ports from pool",
  "deleted_count": 2
}

{
  "internal_id": "minecraft-001",
  "image": "openjdk:17-slim",
  "volume_id": "d6764075-c5f1-4045-9fb3-85315b85cb0f",
  "startup_command": "java -Xmx1G -jar server.jar nogui",
  "start_pattern": "Done.*For help",
  "ports": [
    {
      "ip": "0.0.0.0",
      "port": 25565,
      "protocol": "tcp"
    }
  ],
  "limits": {
    "memory": 1073741824,
    "cpu": 2.0
  },
  "install_script": "#!/bin/bash\nwget https://example.com/server.jar"
}

{
  "message": "Container creation started",
  "internal_id": "minecraft-001",
  "state": "installing"
}

{
  "internal_id": "minecraft-001",
  "container_id": "a1b2c3d4e5f6789",
  "volume_id": "d6764075-c5f1-4045-9fb3-85315b85cb0f",
  "image": "openjdk:17-slim",
  "startup_command": "java -Xmx1G -jar server.jar nogui",
  "start_pattern": "Done.*For help",
  "install_state": "ready",
  "ports": [
    {
      "ip": "0.0.0.0",
      "port": 25565,
      "protocol": "tcp"
    }
  ],
  "limits": {
    "memory": 1073741824,
    "cpu": 2.0
  },
  "mount": {},
  "created_at": 1706450000,
  "updated_at": 1706450100
}

{
  "containers": [
    {
      "internal_id": "minecraft-001",
      "container_id": "a1b2c3d4e5f6789",
      "install_state": "ready",
      "image": "openjdk:17-slim"
    },
    {
      "internal_id": "web-server-001",
      "container_id": "b2c3d4e5f6a7890",
      "install_state": "ready",
      "image": "nginx:latest"
    }
  ]
}

{
  "message": "Container deleted successfully"
}

{
  "message": "Container start initiated",
  "internal_id": "minecraft-001"
}

{
  "message": "Container kill initiated",
  "internal_id": "minecraft-001"
}

{
  "message": "Container restart initiated",
  "internal_id": "minecraft-001"
}

{
  "image": "openjdk:17-slim",
  "install_script": "#!/bin/bash\nwget https://example.com/server.jar"
}

{
  "message": "Container reinstall started",
  "internal_id": "minecraft-001"
}

{
  "ports": [
    {
      "ip": "0.0.0.0",
      "port": 25566,
      "protocol": "tcp"
    }
  ]
}

{
  "message": "Network rebinding started",
  "internal_id": "minecraft-001"
}

{
  "version": "0.1.0",
  "server": {
    "host": "0.0.0.0",
    "port": 8070
  },
  "authorization": {
    "enabled": true,
    "token": "lightd_ad2f7fc49ed640429c450e14ed07c8d5"
  },
  "remote": {
    "enabled": true,
    "url": "https://remote-api.com/api",
    "token": "lightd_ad2f7fc49ed640429c450e14ed07c8d5"
  }
}

{
  "message": "Configuration reloaded successfully"
}

{
  "event": "stats",
  "cpu_usage": 25.5,
  "memory_usage": 536870912,
  "memory_limit": 1073741824,
  "network_rx": 1024000,
  "network_tx": 2048000,
  "block_read": 4096000,
  "block_write": 8192000
}

{
  "event": "console",
  "data": "[Server] Starting Minecraft server version 1.20.4\n"
}

{
  "event": "event",
  "data": "installing"
}

{
  "event": "event",
  "data": "ready"
}

{
  "event": "event",
  "data": "starting"
}

{
  "event": "event",
  "data": "running"
}

{
  "event": "event",
  "data": "exit"
}

{
  "event": "daemon_message",
  "data": "Container started"
}

{
  "event": "logs",
  "data": "[10:30:15] Starting server...\n[10:30:16] Loading world...\n[10:30:20] Done!\n"
}

{
  "error": "Missing or invalid authorization token"
}

{
  "error": "Invalid vendor header"
}

{
  "error": "Container not found"
}

{
  "error": "Volume not found"
}

{
  "error": "Port not found in pool"
}

{
  "error": "Invalid path: path traversal detected"
}

{
  "error": "Cannot rebind network while container is installing"
}

{
  "error": "Port already exists in pool"
}

{
  "error": "Invalid port binding: port not in network pool"
}

{
  "error": "Failed to create Docker container: image not found"
}

{
  "error": "Database operation failed"
}

{
  "error": "Failed to write file: permission denied"
}