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


Navigation

    Cloudron Forum

    • Register
    • Login
    • Search
    • Categories
    • Recent
    • Tags
    • Popular

    Building custom packages

    App Packaging & Development
    1
    1
    181
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • girish
      girish Staff last edited by

      This is a concise guide to building and installing custom packages. For a more detailed explanation, see https://cloudron.io/documentation/custom-apps/tutorial/.

      Prerequisites

      1. Make sure you have docker installed. Also, sign up for a docker hub account (https://hub.docker.com/) and use docker login to login to the docker hub account.

      2. Install the Cloudron CLI tool: npm install -g cloudron. This requires you to install nodejs for npm to work.

      Log into cloudron

      $ cloudron login my.example.com
      Username: girish
      Password: *********
      2FA Token (if enabled): 
      Login successful.
      
      $ cloudron list
      <will list your apps>
      

      Build the app

      All our app packages are open source. You can get them here - https://git.cloudron.io/cloudron (repos with the -app suffix).

      For this tutorial, we will build the ghost app.

      $ git clone https://git.cloudron.io/cloudron/ghost-app
      $ cd ghost-app
      $ cloudron build
      Enter repository (e.g registry/username/org.ghost.cloudronapp2): girish/ghost
      

      The above will build the docker image and push it into docker hub as girish/ghost repository.

      Install the app

      $ cloudron install
      Location: blog
      

      This will install the app you just built into blog.example.com.

      Update the app

      If you make any changes, you have to rebuild the app and update the cloudron with the latest image.

      $ git pull # get latest repo changes
      $ cloudron build
      $ cloudron update --app blog
      

      The update command will update the blog.example.com app with the image we just built.

      That's it!

      1 Reply Last reply Reply Quote 3
      • First post
        Last post