Custom App Gateway Logo

A Custom App Installer for Cloudron

Install Custom Apps with a single command w/o docker or cloudron CLI installation.

DEPRECATED - Cloudron 9.1.3 has native support for Community Apps.

This site will stay live until Cloudron v9.1.3 or later is more widely adopted.

curl -fsSL https://customappgateway.appx.uk/install.sh | bash ....

Supports Linux (x64/ARM), macOS (Intel/Silicon), and Windows (WSL/Git Bash or standalone binary).

Windows users without WSL/Git Bash can download the standalone Windows binary from the advanced section and run it directly.

How it Works

1
Download

The script downloads a secure, temporary binary installer to your machine.

2
Install

The binary fetches an app's manifest and pre-built Docker image, then installs it to your Cloudron.

3
Cleanup

Once finished, the script automatically deletes the installer binary to keep your system clean.

Installation Options

RECOMMENDED

Direct App Install

Install any app from the catalogue below directly by name.

Replace "App Name" with your choice:

curl -fsSL https://customappgateway.appx.uk/install.sh | bash -s -- --install-app "App Name"
  • No app update support

Install CCAI-P Engine

Install the Personal Dashboard to manage your custom apps visually.

Complete command to install CCAI-P Engine:

curl -fsSL https://customappgateway.appx.uk/install.sh | bash -s -- --install-app "CCAI-P"
  • Provides app updates support
  • Provides a personal catalogue

Master App Catalogue

App Name Description Version Author Info
Loading catalogue...

Install Your Own Custom Apps

Use the Installer Binaries Directly

The installer engine is generic and data-driven. You can use the binaries directly to install your own custom apps on your Cloudron, without needing to host a catalogue website.

How to Use:
  1. Download the binary for your OS (from Advanced section).
  2. Ensure your app's Docker image is built and pushed to a registry.
  3. Ensure your CloudronManifest.json is accessible via a URL (e.g., raw git link).
  4. Run the binary with arguments: ./cag-installer --image "image:tag" --manifest "url"
  5. Alternatively, you can still host your own catalogue by creating an apps-config.json and pointing the installer to it using the --catalogue argument.
Download install.sh Get Binaries

Advanced: Standalone Installer Binaries

These binaries are the core engine used by the curl script. Download them directly if you prefer offline installation or manual execution. They support interactive mode (no arguments) or automated mode (CLI arguments).

macOS Binary
Linux Binary
Windows Binary
Interactive vs. Automated Modes

- Interactive Mode: Run the binary without any arguments to be guided through the installation process (e.g., ./cag-installer).
- Automated Mode: Run the binary with CLI arguments to skip interactive prompts (e.g., ./cag-installer --install-app "App Name" --server "https://cloudron.example.com" --token "your-token").

Command Line Reference
Argument Description Example
--install-app / --app Name or ID of the app to install from the catalogue. --install-app "CCAI-P"
--catalogue / --catalogue-url Use a custom catalogue URL instead of the default. --catalogue "https://mysite.com/apps.json"
--server Your Cloudron domain (required for automated mode). --server "my.example.com"
--token Your Cloudron API Token (required for automated mode). --token "my-secret-token"
--location Full subdomain location for the new app. --location "app.example.com"
--image Directly specify a Docker image (overrides catalogue). --image "repo/image:tag"
--manifest Directly specify a Manifest URL (overrides catalogue). --manifest "https://.../Manifest.json"