# Cloud in a Bottle

Cloud in a Bottle is an open-source self-hosting platform that lets you deploy, use, and share web apps on a server you control.

Canonical page: https://ourlocalhost.com/app/8067/cloud-in-a-bottle

## Description

Cloud in a Bottle is an open-source self-hosting platform that lets you deploy, use, and share web apps on a server you control.

## Platform availability

Available on 1 of 10 platforms: Any server.

## Health score

76/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 62 (1,250 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Official website: https://cloudinabottle.org
- GitHub: https://github.com/cloud-in-a-bottle/cloud-in-a-bottle
- Documentation: https://cloudinabottle.org/docs/

## Common questions

### How are deployed apps exposed publicly?

In the standard public deployment, Caddy handles HTTPS and CoreDNS provides wildcard DNS for app subdomains. The router proxies HTTP and WebSocket requests to the correct container based on the app subdomain. By default, the app's main HTTP port is bound to the host’s loopback interface.

### How do I turn an existing Docker app into a deployable app?

Add a cloudinabottle.toml manifest and a Dockerfile to the repository. The platform reads the manifest and builds the Dockerfile with rootless Podman, making the app deployable from Git.

### Where is app data stored, and can archives use external storage?

Platform state and permanent app data are stored on the instance. Archive storage can stay local or use S3-compatible storage that you configure, and the manifest controls which storage tiers a container can access.

### How should API clients authenticate to Cloud in a Bottle?

API clients must provide credentials as an apikey query parameter or a Bearer token in the Authorization header. Keep the key or token secret because it acts like a password for the account.

### How are app updates and logs managed?

The Python router manages updates, logs, and the container lifecycle for installed apps.

## Alternatives

- Better-PaaS
- CasaOS: CasaOS is a lightweight, open-source personal cloud system that turns any small Linux server into an easy-to-use hub for files, application…
- Coolify: Coolify is an open-source, self-hostable platform for deploying web applications, databases, and managed services as an alternative to Hero…
- Cosmos Server: Secure and Easy Self-hosted platform.
- Umbrel: A beautiful personal server OS for self-hosting for any Linux distro.
- YunoHost: YunoHost is a Debian GNU/Linux based server operating system that simplifies self-hosting web services for individuals and small teams with…

---
Source: Our Local Host (https://ourlocalhost.com/app/8067/cloud-in-a-bottle), the self-hosted and open-source app directory.
