# Unikraft > Kraft CLI commands for building and deploying Unikraft unikernels. Use when working with Kraftfiles, deploying to Unikraft Cloud, or managing unikernel instances. - Skill: `majiayu000/unikraft-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add majiayu000/unikraft-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/unikraft-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/majiayu000/unikraft-2 --- # Kraft CLI Reference Build and deploy unikernels with the `kraft` CLI. - Documentation: - Issues & support: - Platform: ## Important: Running Kraft Commands When working with kraft CLI commands: 1. **Always show the commands first** - Tell the developer what commands to run before executing them 2. **Format for copy-paste** - Display commands in a code block ready to copy-paste into the terminal 3. **Ask before running** - Ask if the developer wants you to run the commands, as there can be authentication issues when `UKC_TOKEN` is not set in the AI's terminal session 4. **Let developer run if needed** - If commands fail due to missing tokens, provide the commands for the developer to run manually ## Environment Setup Required for cloud commands (developer must set these in their terminal): ```bash export UKC_TOKEN="your-token" # Unikraft Cloud API token export UKC_METRO=fra # Metro/region (e.g., fra, ams, lon) ``` ## Build Commands ```bash kraft build # Configure and build Unikraft unikernels kraft clean # Remove build object files kraft menu # Open configuration editor TUI ``` ## Project Library Commands ```bash kraft lib add # Add unikraft library to the project kraft lib create # Initialize a library from a template kraft lib remove # Remove a library dependency ``` ## Packaging Commands ```bash kraft pkg list # List installed Unikraft component packages kraft pkg pull # Pull a unikernel and/or its dependencies kraft pkg push # Push a unikernel package to registry kraft pkg update # Retrieve new component/library/package lists kraft pkg info # Show information about a package kraft pkg export # Export a package kraft pkg remove # Remove selected local packages ``` ## Local Runtime Commands ```bash kraft run # Run a unikernel kraft ps # List running unikernels kraft stop # Stop one or more running unikernels kraft start # Start one or more machines kraft pause # Pause one or more running unikernels kraft logs # Fetch the logs of a unikernel kraft remove # Remove one or more running unikernels ``` ## Local Networking Commands ```bash kraft net create # Create a new machine network kraft net list # List machine networks kraft net inspect # Inspect a machine network kraft net up # Bring a network online kraft net down # Bring a network offline kraft net remove # Remove a network ``` ## Local Volume Commands ```bash kraft vol create # Create a machine volume kraft vol ls # List machine volumes kraft vol inspect # Inspect a machine volume kraft vol remove # Remove a volume ``` ## Compose Commands (Local) ```bash kraft compose up # Run a compose project kraft compose down # Stop and remove a compose project kraft compose ps # List running services of current project kraft compose logs # Print the logs of services kraft compose build # Build or rebuild services kraft compose create # Create a compose project kraft compose start # Start a compose project kraft compose stop # Stop a compose project kraft compose pause # Pause a compose project kraft compose unpause # Unpause a compose project kraft compose pull # Pull images of services kraft compose push # Push images of services ``` ## Cloud Deployment Commands ```bash kraft cloud deploy # Deploy your application to Unikraft Cloud kraft cloud quota # View your resource quota kraft cloud tunnel # Forward a local port to an unexposed instance ``` ## Cloud Instance Commands ```bash kraft cloud instance create # Create an instance kraft cloud instance list # List instances kraft cloud instance get # Retrieve the state of instances kraft cloud instance logs # Get console output of instances kraft cloud instance start # Start instances kraft cloud instance stop # Stop instances kraft cloud instance restart # Restart instance(s) kraft cloud instance remove # Remove instances ``` ## Cloud Service Commands ```bash kraft cloud service create # Create a service kraft cloud service list # List services kraft cloud service get # Retrieve the state of services kraft cloud service logs # Get console output for services kraft cloud service drain # Drain instances in a service kraft cloud service remove # Delete services ``` ## Cloud Image Commands ```bash kraft cloud image list # List all images at a metro for your account kraft cloud image remove # Remove an image ``` ## Cloud Volume Commands ```bash kraft cloud volume create # Create a persistent volume kraft cloud volume list # List persistent volumes kraft cloud volume get # Retrieve the state of persistent volumes kraft cloud volume import # Import local data to a persistent volume kraft cloud volume attach # Attach a persistent volume to an instance kraft cloud volume detach # Detach a persistent volume from an instance kraft cloud volume remove # Permanently delete persistent volume(s) ``` ## Cloud Volume Template Commands ```bash kraft cloud volume template create # Create volume template(s) kraft cloud volume template list # List volume templates kraft cloud volume template get # Retrieve the state of volume templates kraft cloud volume template remove # Permanently delete volume template(s) ``` ## Cloud Autoscale Commands ```bash kraft cloud scale init # Initialize autoscale configuration for a service kraft cloud scale add # Add an autoscale configuration policy kraft cloud scale get # Get an autoscale configuration or policy kraft cloud scale remove # Delete an autoscale configuration policy kraft cloud scale reset # Reset autoscale configuration of a service ``` ## Cloud Certificate Commands ```bash kraft cloud cert create # Create a certificate kraft cloud cert list # List certificates kraft cloud cert get # Retrieve the status of a certificate kraft cloud cert remove # Remove a certificate ``` ## Cloud Compose Commands ```bash kraft cloud compose up # Deploy services in a compose project to Unikraft Cloud kraft cloud compose down # Stop and remove services in a deployment kraft cloud compose ps # List active services of a Compose project kraft cloud compose log # View logs of services in a deployment kraft cloud compose build # Build a compose project kraft cloud compose create # Create a deployment from a Compose project kraft cloud compose start # Start services in a deployment kraft cloud compose stop # Stop services in a deployment kraft cloud compose push # Push images to Unikraft Cloud from a Compose project kraft cloud compose ls # List service deployments at a given path ``` ## Useful Flags ```bash --no-prompt # Do not prompt for user interaction --no-color # Disable color output --log-level # Log level: panic, fatal, error, warn, info, debug, trace --help # Help for any command ``` ## Examples Repository Reference examples: https://github.com/unikraft-cloud/examples ### All Example Folders ``` bun # Bun JavaScript runtime caddy2.7-go1.21 # Caddy web server with Go code-server # Browser-based VS Code database-redis7.2 # Redis in-memory store debian-ssh # SSH access environment dragonflydb # Modern Redis alternative duckdb-go1.21 # DuckDB analytical database with Go expressjs4.18-node21 # Express.js framework flask-redis # Flask with Redis flask3.0-python3.12-sqlite3 # Flask with SQLite grafana # Monitoring and visualization haproxy # High availability proxy http-c-debug # C HTTP server (debug) http-elixir1.17 # Elixir HTTP server http-java21 # Java 21 HTTP server http-node25 # Node.js 25 HTTP server http-perl5.42 # Perl HTTP server http-python3.12-FastAPI-0.121.3 # FastAPI framework http-rust-1.79-axum-scale-to-zero # Rust Axum with autoscaling http-rust-trunkrs-leptos # Rust Leptos full-stack http-rust1.91 # Rust HTTP server httpserver-boost1.74-g++13.2 # C++ with Boost httpserver-dotnet10.0 # .NET 10.0 httpserver-dotnet8.0 # .NET 8.0 httpserver-elixir1.16 # Elixir 1.16 httpserver-erlang26.2 # Erlang 26.2 httpserver-g++13.2 # C++ with GCC httpserver-gcc13.2 # C with GCC httpserver-go1.21 # Go 1.21 httpserver-go1.22-redis # Go with Redis httpserver-java17 # Java 17 httpserver-lua5.1 # Lua 5.1 httpserver-nodejs21 # Node.js 21 httpserver-perl5.38 # Perl 5.38 httpserver-php8.2 # PHP 8.2 httpserver-python3.12 # Python 3.12 httpserver-python3.12-django5.0 # Django 5.0 httpserver-python3.12-flask3.0 # Flask 3.0 httpserver-ruby3.2 # Ruby 3.2 httpserver-rust1.73 # Rust 1.73 httpserver-rust1.75 # Rust 1.75 httpserver-rust1.81-rocket0.5 # Rust Rocket framework httpserver-rust1.87-actix-web4 # Rust Actix-web hugo0.122 # Hugo static site generator imaginary # Image processing service java17-spring-petclinic # Spring Framework sample java17-springboot3.2.x # Spring Boot mariadb # MariaDB database mariadb11.7-volumes # MariaDB with volumes mcp-server-arxiv # MCP for arXiv mcp-server-simple # Basic MCP server memcached1.6 # Memcached minio # S3-compatible storage mongodb # MongoDB database nginx # Nginx web server nginx-flask-mongo # Nginx + Flask + MongoDB nginx-vite-vanilla # Nginx with Vite node-express-puppeteer # Express with Puppeteer node-playwright-chromium # Playwright (Chromium) node-playwright-firefox # Playwright (Firefox) node-playwright-webkit # Playwright (WebKit) node-vite-ssr-vanilla # Vite SSR node-vite-vanilla # Vite vanilla node18-agario # Agar.io game node18-wingsio # Wings.io game node21-nextjs # Next.js framework node21-remix # Remix framework node21-solid-start # SolidJS framework node21-sveltekit # SvelteKit framework node21-websocket # WebSocket example node24-karaoke # Karaoke application opentelemetry-collector # OpenTelemetry postgres # PostgreSQL database prisma-expressjs4.19-node18 # Prisma ORM with Express python-playwright-chromium # Python Playwright python3.12-flask3.0-sqlite # Flask with SQLite ruby3.2-rails # Ruby on Rails skipper0.18 # HTTP router spin-wagi-http # WebAssembly Gateway Interface traefik # Traefik proxy tyk # API gateway vnc-browser # Browser-based VNC vsftpd # FTP server wazero-import-go # WebAssembly for Go webhook-github-node # GitHub webhook handler wordpress-all-in-one # WordPress single deploy wordpress-compose # WordPress with Compose ```