CCAI : Cloudron Custom App Installer
-
Yes, I want to able to support this natively in Cloudron itself. I think we will put this in 9.1 roadmap. But before we implement, we will make a proposal here just to make sure it is what everyone is expecting . Probably only after new years though since most of the team is off and on given holidays.
-
Announcing ...
CCAI-P : Cloudron CustomApp Installer Personal Edition
Recognising that many users are reluctant to enter their cloudron credentials on an open url, I have adapted the current "open" CCAI custom app installer, into a "closed" app using cloudron ProxyAuth for authentication, and a token for installations.
While a one-time install of the Personal CustomApp Installer is needed, manually or using the hosted CCAI, after that, the user is secure with their own app deployment, and credentials do not need to be entered on a 3rd party site.
The Personal Edition has a button to import the master app catalogue when needed.
The Personal Edition feels a lot faster as no login code / 2FA is needed.
My Git Repo : https://git.cloudron.io/timconsidine/cloudron-customapp-installer-personal
Built Docker Image : tcmbp132021/cloudron-customapp-installer-personal:v1.0.0
Available on the open CCAI site https://ccai.appx.uk
-
Update 20/01/2026 :
-
I am deprecating installation of the open version of CCAI, as I don't really see that anyone would want to host their own open version.
It's still available, but you will have to hunt for it or ask me.
Basically I've removed it from the catalogue. -
I've updated CCAI-P which is the preferred self-host app.
Runs on your own instance, credentials are stored in the app on your server -
timeouts removed from CCAI-P : you're logged in or you're not : logout button for security, but you can leave it running if it's only you have access to it
-
added 3 new descriptors :
- packageAuthor : previously implied, now explicit
- appNote : extended explanation of the catalogue entry
- appHomepage : clickable link to the app's Homepage so you can read about it
-
it will take a little while for me to populate the new fields for all apps, but will get on with it.
@staff : can I modify the AppWishlist to the effect :
- please DO NOT add CCAI to the AppStore
- please DO add CCAI-P to the AppStore
- or please make your own version (which I am sure will be more lovely)
There are clear pain points in installing custom apps.
This is eminently resolvable.
The problem is without an official way to get CCAI-P, users still have to go through those pain points. Maybe only once, but that's enough to deter them.The growing catalogue of custom apps (and there are many more that I am not aware of) shows that relying on the App Store only, and relying on approval of items into the App Store, is a clear bottle neck to maximum use and efficiency of a user's Cloudron instance.
EDIT : at the risk of over-selling the point, can Cloudron staff imagine this ? A daily workload where they never ever have to think about adding apps to the Cloudron AppStore, unless they really want to. No more user pressure.
Indie app dev, scratching my itches, lover of Cloudron PaaS
-
-
Update 20/01/2026 :
-
I am deprecating installation of the open version of CCAI, as I don't really see that anyone would want to host their own open version.
It's still available, but you will have to hunt for it or ask me.
Basically I've removed it from the catalogue. -
I've updated CCAI-P which is the preferred self-host app.
Runs on your own instance, credentials are stored in the app on your server -
timeouts removed from CCAI-P : you're logged in or you're not : logout button for security, but you can leave it running if it's only you have access to it
-
added 3 new descriptors :
- packageAuthor : previously implied, now explicit
- appNote : extended explanation of the catalogue entry
- appHomepage : clickable link to the app's Homepage so you can read about it
-
it will take a little while for me to populate the new fields for all apps, but will get on with it.
@staff : can I modify the AppWishlist to the effect :
- please DO NOT add CCAI to the AppStore
- please DO add CCAI-P to the AppStore
- or please make your own version (which I am sure will be more lovely)
There are clear pain points in installing custom apps.
This is eminently resolvable.
The problem is without an official way to get CCAI-P, users still have to go through those pain points. Maybe only once, but that's enough to deter them.The growing catalogue of custom apps (and there are many more that I am not aware of) shows that relying on the App Store only, and relying on approval of items into the App Store, is a clear bottle neck to maximum use and efficiency of a user's Cloudron instance.
EDIT : at the risk of over-selling the point, can Cloudron staff imagine this ? A daily workload where they never ever have to think about adding apps to the Cloudron AppStore, unless they really want to. No more user pressure.
@timconsidine said in CCAI : Cloudron Custom App Installer:
The problem is without an official way to get CCAI-P, users still have to go through those pain points. Maybe only once, but that's enough to deter them.
Not in a million years would I have been able to install a custom app on my own. CCAI-P makes it stupidly easy. Thank you Tim! -
-
@timconsidine said in CCAI : Cloudron Custom App Installer:
The problem is without an official way to get CCAI-P, users still have to go through those pain points. Maybe only once, but that's enough to deter them.
Not in a million years would I have been able to install a custom app on my own. CCAI-P makes it stupidly easy. Thank you Tim!@humptydumpty and I am working on another non-Cloudron way to get over the blockage of getting CCAI-P into the AppStore. One simple download.
But ssssh, don’t tell anyone yet
-
The Problem :
The Solution :
NEW : CustomAppGateway
-
no more technical or knowledge blocks
-
no more excuses
-
a whole new world of opportunity opened up
-
available in your preferred approach
- hosted service : zero setup
- self-hosted deployment : private setup
- binary tool : tiny run-once local setup
- security : single-use token (optionally also IP address limited to only you )
Release : 21st January 2026
Standby ....
-
-
[Announce] CustomAppGateway (CAG) – Solving the "Chicken & Egg" for Custom Apps
Hi everyone,
I'm excited to share a new project that I hope will be a valuable addition to our ecosystem: CustomAppGateway (CAG).
Available now at CAG Website
The "Chicken & Egg" Problem
For a while now, I've been working on CCAI and then CCAI-P (Cloudron Custom App Installer - Personal), a tool designed to be the primary "Install UI" for custom apps. It empowers you to easily install packaged custom apps that aren't yet in the official store.
However, there is a catch-22: How do you install the installer (CCAI-P) without using the CLI ?
Enter CustomAppGateway (CAG)
CustomAppGateway is the solution to that problem. It is a specialized, lightweight run-once tool designed solely to deploy CCAI-P to your Cloudron instance securely and easily.
It provides three simple methods:
- CAG Online (Hosted): A web-based installer that runs securely in your browser (using a proxy to handle CORS, with tokens processed in memory only).
- CAG Web (self-hosted) : same as above but made easy to deploy to your own server.
- CAG App (Downloaded): A standalone terminal executable for Mac, Windows, and Linux for those who prefer a local utility.
AppStore Independence
CAG and CCAI-P are about AppStore Independence. You are not reliant on waiting for an app to be officially adopted or packaged by the Cloudron team to use it, if you need it NOW.
That said, the Cloudron App Store remains vital. It provides the seamless, tested update mechanism we all rely on. While custom apps give us freedom and immediacy, the App Store is still the gold standard for long-term maintenance and stability.
Updates & Housekeeping
- CCAI-P is now the primary interface for installing custom apps and will receive further updates and improvements.
- The old CCAI open hosted version is effectively deprecated and will be archived/deleted. I encourage everyone to switch to using CCAI-P.
Security
A hot topic which I’ve taken seriously.
CAG leverages the excellent security baked into the Cloudron platform.
We focus on :- using a dedicated one-time token which you create and subsequently delete
- restricting the token to use only on your IP address
The footprint for attack is tiny.
A Note to the Cloudron Team
I want to extend a huge and ongoing thank you to the Cloudron team for their continued, tireless efforts. Cloudron remains the #1 self-hosting platform because of your hard work.
We know you face time and effort constraints with a small team. My hope is that CustomAppGateway and CCAI-P can ease your burden a little by empowering the community to self-service their custom app needs, allowing you to focus on the core platform and official apps.
Where to get it
Status
- hosted installer : zero setup : tested
- web installer : private setup : tested
- desktop installer : minimal setup : tested on MacOS
- TODO :
- test desktop installer on Windows
- test desktop installer on Linux
Feedback is always welcome!
And in doing so, please cut me some slack - it's a ground-breaking project, and as such may have some gremlins for a short (hopefully) while. -
House-keeping :
- Cloudron have announced they will introduce support "in-platform" for custom app deployments
- consequently CCAI (the open hosted-as-a-service version) can no longer be installed from CCAI. (It can be installed manually if really needed but I don't really see why anyone would want to).
- CCAI-P (the personal edition which stores auth creds locally in app) can no longer be installed from CCAI : if you want CCAI-P, use the new https://customappgateway.appx.uk distribution point
- CCAI-P has been cleaned of legacy auth timeouts (inherited from original CCAI) so runtime gremlins should not occur. There is still a manual logout and connect option, in case the user wants to do so manually. Otherwise it should remain 'ready to go' without timeouts.
Improvements :
- both CCAI and CCAI-P still focus on new installations, and there is no support for updating an existing custom app. I am working on introducing support for updates.
The Future :
- with Cloudron's announcement that their v9.1 release will include some support for in-platform deployment of custom apps, "the writing is clearly on the wall" and CCAI / CCAI-P / CustomAppGateway will die and git repos / docker images will be removed at some point.
- I doubt anyone is more pleased than me !
- however we do not know the timescales for Cloudron 9.1 (other big stuff in it too), so I will continue to make available CCAI / CCAI-P until some point after Cloudron 9.1 is stable.
- Cloudron have announced they will introduce support "in-platform" for custom app deployments
-
@timconsidine I left a note at https://forum.cloudron.io/topic/14976/what-s-coming-in-9.1/11 about how we plan to implement this. I don't have a timeline for 9.1 but given the build up all your apps, we are trying to get this out asap!
-
@timconsidine I left a note at https://forum.cloudron.io/topic/14976/what-s-coming-in-9.1/11 about how we plan to implement this. I don't have a timeline for 9.1 but given the build up all your apps, we are trying to get this out asap!
@girish thank you - very helpful - still digesting it.
Hoping to get my final "end of life" changes done today, which can allow CCAI-P to limp on until Cloudron in-platform functionality is tested, then turn the CCAI and CAG websites into digital tombstones.
No need for any rush - always happy for you to take your time to do a proper job (unlike my hashed together PoC).
