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.
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
Variants
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
- Cloud in a Bottle: making self-hosting accessible to everyone (forum)
- PC - cloud in a bottle | Terraria Community Forums (forum)
- DAE dislike Cloud in a Bottle? : r/Terraria - Reddit (reddit)
- Cloud in a Bottle : r/minecraftsuggestions - Reddit (reddit)
- Items - Cloud in a bottle (Crafting) | Terraria Community Forums (forum)
- Cloud In A Bottle | Hypixel Forums (forum)
Collected today - public community threads