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.

  • Infrastructure
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

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
100last commit 1 day ago
Popular
621,250 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
1,250
Open issues
6
Last commit
2026-11-20
Latest release
v0.3.3
License
AGPL-3.0
Activity
rising

Checked today - source: GitHub (cloud-in-a-bottle/cloud-in-a-bottle)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

  • Set your API key or token first Before the app can talk to Cloud in a Bottle, provide your credentials as either an apikey query parameter or a Bearer token (an access credential sent in the Authorization header). Without one, the API will not know who you are and will reject the call. source
  • Treat API keys and tokens like passwords Keep your API key or Bearer token secret and only put it in your app's secure settings, because it acts like a password for your Cloud in a Bottle account. If it leaks, others may read or change your data. source
  • Choose where it runs It can run on an old laptop, your own VPS, or a rented instance. source

Fetched today - each note links to its source

Alternatives (6)

  • 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…

Checked today - source: AlternativeTo

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.

Answers sourced from api.crmincloud.it, github.com

Community

Collected today - public community threads