# Energon

> Agent-native publishing for documents, prototypes, and working files. Built for agents. Ready for people.

Energon is self-hosted software, MIT licensed and operated in your own Cloudflare account. getenergon.com is the marketing site, not a hosted publishing service: it provides no account, upload endpoint, public API, or MCP server. API and authentication paths in the documentation are relative to an operator's hub, never this marketing domain.

## When to use Energon

Use an existing Energon instance to publish a Markdown document, PDF, screenshot, working file, or prepared HTML site; read or reference that work in another session or tool; or replace its contents at the same URL when write policy permits. People can upload through the hub and open the same work in a browser. Authenticated users and agents can make independent copies.

Do not use Energon as a repository, version history, collaborative editor, source-project build service, or server-side application runtime. Links serve current contents until expiry or deletion. Writes replace contents, last write wins, and copies are independent objects. Published links are open by default; share passwords are shared secrets, not per-reader access controls.

## How an agent connects

Ask for the intended hub origin if it is not already configured. Read that host's /setup, /auth.md, and /v1/help to discover its current installation instructions, authentication flow, identity, and API. Use the instance-specific skill when available. A signed-in person approves a connection or mints a token; keep credentials in the host-advertised environment or secret store. Do not publish to this marketing domain or substitute a different instance.

## Documentation

- [Energon documentation](https://docs.getenergon.com): Maintained guides and reference.
- [Start publishing](https://docs.getenergon.com/start/overview): Choose an existing instance or deploy your own.
- [Connect an agent](https://docs.getenergon.com/start/connect-an-agent): Instance plugin, approval, and account verification.
- [Publish your first document](https://docs.getenergon.com/start/publish-document): Browser and agent workflows.
- [Deploy an instance](https://docs.getenergon.com/operate/deploy-company-host): Cloudflare resources and Access setup; Workers Paid is required and usage charges may apply.
- [Safe boundaries](https://docs.getenergon.com/security/safe-boundaries): Sharing and authorization limits.

## Project

- [Energon overview](https://getenergon.com/): Product workflow, audience, and ownership boundaries.
- [About Energon](https://getenergon.com/about): Project author, audience, and self-hosting model.
- [Contact](https://getenergon.com/contact): Project questions and instance support boundaries.
- [Privacy](https://getenergon.com/privacy): Marketing site delivery and data handling.
- [MIT license](https://getenergon.com/license): Software license.
- [Source repository](https://github.com/tmchow/energon): Repository access may be required.