---
name: kedge
description: Deploy and publish websites, HTML, Markdown, static files, source applications, functions, and container images to a public HTTPS URL using Kedge. Use when asked to deploy a website or small web app, publish content or code, put a page online, create a shareable preview URL, or operate an existing Kedge app.
---

# Kedge

Use the shortest applicable workflow. No need to fetch documentation before a basic deployment.

## Publish content directly

Pipe a single file or generated content over SSH:

```bash
ssh kedge.dev < index.html
```

Markdown becomes HTML.

## Publish a directory

If `kedge` is already available, prefer its shorter directory workflow:

```bash
kedge up
```

Otherwise, for an existing Git repository, commit only the intended content, add a namespaced remote, and push directly:

```bash
account="$(ssh kedge.dev whoami)"
git remote add kedge "ssh://kedge.dev/$account/<app>.git"
git push kedge HEAD:main
```

For a one-off non-Git directory, upload the tree directly:

```bash
scp -r public/ kedge.dev:<app>/
```

For ongoing deployments from a non-Git directory, initialize Git, commit the intended content, and follow the Git workflow above.

An SSH key identifies the Kedge account.

## Reference

- Documentation index: https://kedge.dev/llms.txt
- Complete documentation: https://kedge.dev/llms-full.txt
- Quickstart: https://kedge.dev/docs/quickstart.md
- Deployment workflows: https://kedge.dev/docs/deploy.md
- CLI and SSH reference: https://kedge.dev/docs/cli.md