Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now.


Skip to content

App Packaging & Development

App package development & help

279 Topics 2.6k Posts

Subcategories


  • Looking to collaborate? Post here if you need help or willing to offer help.

    36 276
    36 Topics
    276 Posts
    robiR
    Make sure to try them with CCAI
  • Cloudron CLI - Updates

    Pinned
    16
    0 Votes
    16 Posts
    1k Views
    girishG
    [6.0.0] Various changes to accomodate Cloudron 9 release API changes add --siteId to cloudron backup to specify site id explicitly
  • App contributions hall of fame

    Pinned Moved
    42
    10 Votes
    42 Posts
    13k Views
    LanhildL
    @girish Missed that message. Yeah, Open WebUI is the one that made it to published. I've made several other things but they're mostly to learn packaging/tests (such as a standalone DB app, etc.)
  • Translators hall of fame

    Pinned Moved
    27
    16 Votes
    27 Posts
    7k Views
    nebulonN
    Currently this is not possible, we only manually add translators to avoid spam. Due to the vast changes of translation strings for the new UI, we are yet to purge and merge strings. So may not be too useful at the moment to suggest changes, but I am very happy to create an account for you for the future. Please mail your preferred email address to support@cloudron.io for this and we can handle it there.
  • Read first before starting to package an app

    Pinned
    10
    8 Votes
    10 Posts
    6k Views
    nebulonN
    I guess the current link would be https://docs.cloudron.io/packaging/tutorial/
  • Building custom packages

    Pinned
    6
    4 Votes
    6 Posts
    3k Views
    girishG
    @Grienauer We haven't yet had a case where different data directories of apps cannot be symlinked to a subdirectory /app/data . It keeps backup/restore logic simple if we limit to one folder. Do you have an app in mind which cannot do this? Usually, we manage to change apps to use supervisor and thus package multiple containers into one. I guess it's possible to implement this, we haven't yet.
  • Writing automated tests for packages

    Pinned
    12
    8 Votes
    12 Posts
    4k Views
    BrutalBirdieB
    @nebulon Yea I just wanted to reply never mind, I copied the tests from the alltube app which do not even use selenium so yeeaa my mistake. Now I took the nextcloud tests and will learn from them
  • Cloudron Non-App Store Packaged Apps

    Pinned
    27
    11 Votes
    27 Posts
    8k Views
    T
    @matbrgz added to the post at the top!
  • Blossom Server package

    10
    6 Votes
    10 Posts
    2k Views
    scookeS
    @nostrdev-com I've installed it, went smooth, and have even uploaded a blob. How do I make this private? I really don't want some random to upload nasty stuff! Here is some of my config: discovery: # find files by querying nostr relays nostr: enabled: true relays: - wss://relay.mynostr.com # - wss://nostrue.com # - wss://relay.damus.io # - wss://nostr.wine # - wss://nos.lol # - wss://nostr-pub.wellorder.net # find files by asking upstream CDNs # NOTE: do not set this to your own server, it will create an infinite loop upstream: enabled: true domains: - https://cdn.satellite.earth storage: # local or s3 backend: local # Imminently removes a blob when there are no owners removeWhenNoOwners: false # local storage local: dir: ./data/blobs # rules are checked in descending order. if a blob matches a rule it is kept # "type" (required) the type of the blob, "*" can be used to match any type # "expiration" (required) time passed since last accessed # "pubkeys" (optional) a list of owners # any blobs not matching the rules will be removed rules: # mime type of blob - type: text/* # time since last accessed expiration: 1 month - type: "image/*" expiration: 1 year - type: "video/*" expiration: 5 days - type: "model/*" expiration: 1 week - type: "*" expiration: 2 days upload: # enable / disable uploads enabled: true # require auth to upload requireAuth: true # only check rules that include "pubkeys" requirePubkeyInRule: false list: requireAuth: true allowListOthers: false tor: enabled: false proxy: ""
  • Stuck on packaging

    3
    2 Votes
    3 Posts
    68 Views
    jadudmJ
    Many thanks, @james. The text was absolutely helpful. Also, that diff hint is gold. I may end up with a PR against the docs when I'm done, because that kind of hint is a nice trick to figure out quickly all the places an app touches the disk.
  • Deepcode successfully installed in LAMP App

    3
    0 Votes
    3 Posts
    73 Views
    robiR
    @joseph Yes, I thought I mentioned that just before the apache app.conf. It does. Thanks for chiming in!
  • [Package] Typesense Search Engine - Fast, Typo-Tolerant Search

    15
    7 Votes
    15 Posts
    1k Views
    Dave SwiftD
    Hi @girish, @nebulon, and team, I've updated the Typesense package to address the backup roadblock from the docs (https://typesense.org/docs/guide/backups.html#backup-steps). This should make it compatible with Cloudron's strategy for database-like apps. Key changes in v29.0.1: Added "localstorage" addon for persistent /app/data (includes DB files and snapshots). Defaulted data-dir to /app/data in start.sh. Added backup.sh to trigger a full server snapshot via /operations/snapshot API, saving to snapshots/latest.tar (relative to /app/data). It backs up all collections automatically and checks for success. Added restore.sh to untar latest.tar on startup if present, ensuring consistent restores. Improved logging for the API key in start.sh. Tested on my live install (search.daveswift.com with existing collections)—backup creates the snapshot file, and restore loads it on restart without issues. The snapshot is a complete dump of all data, per Typesense docs. Repo: https://github.com/clientamp/typesense-cloudron (changes on main, see CHANGELOG.md). Latest image: clientamp/typesense-cloudron:29.0.1 (or timestamped builds like 20250929-111100). For integration, Cloudron could run backup.sh via a hook before filesystem backup, then ignore raw DB files. Happy to add more (e.g., compression). Thanks!
  • Matrix WhatsApp Bridge

    20
    5 Votes
    20 Posts
    3k Views
    andreasduerenA
    @girish said in Matrix WhatsApp Bridge: "extensions" to apps by third parties is quite a burden for app packages. I understand that it needs to be feasible to maintain these kind of things. Cloudron needs to be profitable after all. I hope we can find some solution for these things, especially if they're simple go binaries like this one.
  • Installing custom Apps on Cloudron

    71
    7 Votes
    71 Posts
    14k Views
    timconsidineT
    @scooke raises some valid points about user expectations, and I will freely admit that I am not sure where or how the line should be drawn. Conceptually there is indeed some friction between : user is not comfortable installing CLI tools and docker and using them, effectively setting a competence bar and edging them out of this activity making it easier to do what they're not comfortable with, effectively lowering that bar and inevitably encountering support requests if/when it becomes normal/easy to install unsupported apps (via @Kubernetes scripts, my tool or an official way) However I am clear on these points : installing custom apps should be easier (hence my app) : on one level, it's purely and simply a timesaver, e.g. for a user who is competent in installing apps, at least that's how I am using my tool currently nothing wrong in concept with Cloudron providing an official GUI for installing custom apps (Cloudron has already provided the CLI and know-how for non-gui) support line must be clear : Cloudron as a team/business are not responsible for custom apps (not supported, not maintained) if properly handled, easier installation of custom apps can reduce forum pressure on Cloudron team for new apps into the AppStore I like @scooke idea of a pop-up confirmation box or similar : clarity and disclaimer is good. Whether it goes as far as requiring a reboot of the Cloudron instance, I'm not sure. But I will add a disclaimer box to my app. Beyond that, it gets a bit unclear for me : does the packager provide support (my view : only optionally / voluntary / reasonable efforts) do packagers need a reputation score (my view : nice but not viable as a formal rating, who has time and authority to set these, instead maybe some unofficial star rating 1-5 from users with successful deployment of a custom app) can an installer for custom apps provide a monetisation mechanism (comment from @girish) which effectively incentivises packagers to work through the AppWishlist (my view : yes, it could, but it's another layer on-top) should support for installed custom apps be channelled (a) into an UNSUPPORTED category of existing Cloudron forum, or (b) very deliberately into a different forum (my view : B makes a point but A is easier and more natural) @scooke said in Installing custom Apps on Cloudron: Please do not turn Cloudron into another messy Yunohost. I agree 100% on this. It must definitely be the goal of any efforts in this area. Equally, IMHO, standing still is not an option. We have too many well-intentioned but actually not-our-business "lectures" about how Cloudron should expand, and also too many "please please please" requests, pointing to unmet user demand. We cannot be like King Canute trying to push the waves back.
  • Separate build and runtime images?

    3
    0 Votes
    3 Posts
    256 Views
    E
    Yes, thank you, this has worked perfectly!
  • RomM App For Cloudron

    Moved
    12
    2
    4 Votes
    12 Posts
    2k Views
    murgeroM
    Bumping to let people know I have not forgotten, its just been a busy summer for me!
  • Install new custom app with environment variables?

    8
    1 Votes
    8 Posts
    667 Views
    E
    @girish said in Install new custom app with environment variables?: @ekevu123 cloudron install --env ENV1=1 ENV2=2 --location subdomain . Then, you can verify using cloudron env list. Thank you! I think this is the best solution for this problem.
  • tcpPort routing

    routing ports
    3
    0 Votes
    3 Posts
    325 Views
    timconsidineT
    Thank you @James In the interim, I am attempting a workaround <can't find fingers-crossed emoji>
  • Failed to install app: 424 message: App purchase failed.

    10
    1 Votes
    10 Posts
    807 Views
    timconsidineT
    @girish thanks for looking into it all working now, so probably a glitch somewhere, not worth investigating further
  • [WIP] a Soulseek client with modern Web UI for Cloudron

    7
    3 Votes
    7 Posts
    2k Views
    SansGuidonS
    I've my Last.fm account since 2010, but nowadays I'm also scrobbling to https://listenbrainz.org/ as a backup in case Last.fm dies. I also aim to make my own scrobbler/stats independently from ListenBrainz and Last.fm, taking inspiration from https://coryd.dev/posts/2024/tracking-the-music-i-listen-to and https://sive.rs/ti
  • Custom subdomain per user

    4
    1 Votes
    4 Posts
    340 Views
    E
    Okay, thank you for the advise!