server

Quick Start Guide

This guide will help you get up and running with Veridock Server in just a few minutes.

Prerequisites

Step 1: Start the Server

  1. Open a terminal and navigate to your project directory
  2. Start the server:
    make run
    

    This will start:

    • gRPC server on port 50051
    • HTTP gateway on port 8082
    • Caddy web server on port 2019

Step 2: Verify the Installation

Open your web browser and navigate to:

http://localhost:2019

You should see the Veridock web interface.

Step 3: Running Your First Command

Using the Web Interface

  1. Open the web interface at http://localhost:2019
  2. Navigate to the “Runtime” section
  3. Enter a command in the input field (e.g., echo "Hello, Veridock!")
  4. Click “Run” and see the output

Using cURL

curl -X POST http://localhost:8082/makefile/run_command \
  -H "Content-Type: application/json" \
  -d '{"command": "echo \"Hello, Veridock!\""}'

Using the CLI

veridock run "echo 'Hello, Veridock!'"

Step 4: Explore the API

List Available Commands

curl http://localhost:8082/makefile/list_commands

Get System Status

curl http://localhost:8082/status

Step 5: Create Your First Service

  1. Create a new service:
    veridock service add my-service
    
  2. Start the service:
    veridock service start my-service
    
  3. Check service status:
    veridock service status
    

Next Steps