kortix-apps

Deploy and operate static sites, bundles, and container services on Kortix Apps.

20.2k|3.4k|Updated Oct 5, 2024
One-click install
npx skills add https://github.com/kortix-ai/suna --skill kortix-apps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kortix-apps
Source: https://github.com/kortix-ai/suna/tree/main/packages/starter/templates/managed/.kortix/opencode/skills/kortix-apps
Command: npx skills add https://github.com/kortix-ai/suna --skill kortix-apps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishing a web app or service to a stable URL normally requires choosing a hosting provider, configuring infrastructure, and managing deployments by hand. This Skill turns one source tree or container image into an immutable serverless deployment on Kortix Apps through the pre-authenticated CLI, handling access control, verification, and lifecycle operations.

Core Features & Use Cases

  • Multi-source deployment: Deploy static HTML/CSS/JS, prebuilt Vite or React dist folders, source bundles, Next.js exports, Dockerfile services, or existing OCI images with a single kortix apps deploy command.
  • Access control: Set private, project, restricted, password, or public access modes, and generate short-lived signed access links for authenticated browser sessions.
  • Verification and lifecycle: Verify deployments by fetching the stable URL and hashed assets, diagnose failures from deployment logs, and run start, stop, rollback, and delete operations.
  • Use Case: You built a React storefront and want it live. Run kortix apps deploy ./dist --slug storefront --type static --spa, then verify the stable URL returns 200 with the expected content.

Quick Start

Ask the agent to deploy the current build output directory as a static SPA to Kortix Apps and verify the stable URL responds correctly.

Frequently Asked Questions about kortix-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a static site to Kortix Apps?

Run kortix apps deploy with your build output directory, for example kortix apps deploy ./dist --slug myapp --type static --spa. The command creates the App identity, uploads the source, and blocks until the stable URL is ready.

How do I deploy a Dockerfile or container image as an app?

Use --type dockerfile with a command and target port for a Dockerfile service, or pass --image with an existing public OCI image. Include a readiness path so Kortix knows when the service is healthy.

What source types does Kortix Apps support?

Kortix Apps supports static files, prebuilt SPA dist folders, source bundles, Next.js static exports, Dockerfile-based services, and existing OCI images. All current source kinds run on the sandbox hosting backend.

Can I make a Kortix App public or password protected?

Yes, use kortix apps access with modes private, project, restricted, password, or public. New Apps default to private, and passwords are stored only as Argon2id hashes.

Why does my Kortix App return 202 after being stopped?

A stopped App wakes on the next authorized request, returning 202 with Retry-After while the provider resumes it. Poll for up to 120 seconds until the final response is 200.

How do I roll back a Kortix App deployment?

Run kortix apps rollback with the App slug and a ready immutable deployment id from kortix apps show. Rollback only accepts deployments in the ready state.