Introduction

This is the Cloud in a Bottle Manual. It documents the platform from the perspective of an owner (someone running a Cloud in a Bottle instance) and of an app author (someone packaging an application to run on Cloud in a Bottle).

For owners

Sections about installing an instance, running apps on it, keeping the data safe, and debugging when things go wrong.

For setup docs, choose the guide that matches your desired deployment location:

• Deploying on a cloud instance
• Deploying on a dedicated home server
• Deploying on a shared home machine

Once your instance is up, things should be mostly self explanatory, but see Using your instance for usage details. Then set up Backups.

For app authors

Sections about how Cloud in a Bottle expects an app to be packaged: the manifest format, the runtime contract, what your container can expect from the environment, and how to integrate with the Cloud in a Bottle identity / permissions / inter-app services machinery.

If you're building an app from scratch, start at Creating an App. If you have an existing app and want to know which knob in cloudinabottle.toml controls what, jump to the App Manifest Spec.

Improving the docs

PRs against docs/src/*.md in the cloud in a bottle repo are welcome.