Documentation guide

Keelson helps your team use internal apps built with AI tools or other development tools. Along with deploying and running your app, it handles login and lets you choose which members can access it.

To get started, create an account or sign in to the Keelson console.

Ask AI about Keelson

You can ask questions about Keelson in ChatGPT, Claude Code, or another AI tool you use. Click Copy in the bar at the top of the page and send the URL along with your question. Describe how your app is built to ask whether it can run on Keelson and what changes it needs.

Try the following prompt, replacing the app description with your own:

https://keelson.dev/llms.txt

Read the documentation at this URL and follow relevant links as needed.
I want to deploy an internal app built with Python and SQLite to Keelson.
Tell me whether it is supported and what I need to prepare.

Choose your starting point

Try a sample app Deploy a sample and check that only signed-in users can open it. Takes about 15 minutes.

Bring an existing app Deploy an app built with Lovable, Bolt, v0, or your own development tools.

Solve a problem Find help when a deployment fails, someone cannot open an app, or saved data disappears.

Supported apps and use cases

Keelson supports Python, Node.js, and Go web apps, prebuilt static sites, and scheduled jobs that run at set times or intervals. It is designed for internal business apps used by a few people to a few hundred people. The number of app users does not affect the price.

Apps that require an always-running server, WebSockets, or a GPU are not supported. See Supported apps and constraints for frameworks and detailed requirements.

Existing apps that meet these requirements can be deployed after adjusting their configuration and any code that depends on the runtime environment. You do not need to rewrite the entire app for Keelson. You can also keep using existing external databases and services. See Bring an existing app for the preparation steps.

For considerations when moving an app to another environment, see the FAQ.

Visit the main website for an overview and pricing.

Guides by role

Build and deploy apps

Start here

• Quickstart — try deploying a sample app
• Core concepts — learn the terminology and what Keelson provides versus what your app implements
• Supported apps and constraints — check whether your app can run on Keelson

Refer to these as needed

• When apps run — understand when apps start and stop, and how to run tasks
• Databases and Files and media — choose where to store data and files
• Use the signed-in user’s identity — record who created data or tailor what each user sees
• Deploy an app and Update and restore — deploy updates and return to an earlier version
• keelson.yaml reference and CLI commands — look up settings and commands

Manage members and access

• Invite members — invite people to your workspace
• Members and roles — understand roles and what each role can do
• Share an app with your team — restrict an app to a specific team
• Groups and app permissions — configure who can use each app
• IP restrictions — choose which IP addresses can access your apps
• Plans and limits and Billing and subscriptions — review plan limits and manage your subscription

Develop and deploy with an AI agent

The Keelson Deploy Spec describes the requirements and configuration for deploying an app. Give your AI agent the following URL and ask: “Read this specification and review my app’s code, then suggest the changes needed to deploy it to Keelson.”

https://keelson.dev/docs/reference/deploy-spec.txt

The Agent Skill installed by keelson install-agent includes the Deploy Spec and instructions for adapting Python, Node.js, and Go code.

To give an AI tool all the documentation in one file, use /llms-full.txt. To get an individual page as Markdown, replace the trailing / in its URL with .md (for example, /docs/introduction/quickstart/ → /docs/introduction/quickstart.md).

Frequently asked questions

See the FAQ for common questions before getting started.