Incapio - Blog Posts © 2022 by Incapio is licensed under CC BY-SA 4.0 

Beginner's Guide to Cloudron: Everything You Need To Know

Updated: Jan 28

Prerequisites:

You will need the following items to complete this tutorial

  1. A Compute Engine (VM) Instance up and running with Cloudron.

How to install cloudron on Ubuntu?.

To complete this tutorial, Please install Cloudron on the Compute Engine in Google Cloud Platform. The following post explains how to install Cloudron in Compute Engine.

https://www.incapio.com/post/how-do-i-set-up-cloudron-on-google-cloud-platform


What is Cloudron control panel?

Cloudron is a cloud application platform that allows you to create applications with only one click. Their 80+ stable apps have been thoroughly tested and approved for trouble-free operation. It automates everything from database configuration and DNS record setup to certificate installation and management. In addition, Cloudron provides a centralized platform for managing users and online apps from the convenience of your web browser.

Why do we need Cloudron?

Assume you wish to create a web application such as WordPress, Confluence, or an email server. The first step is to begin reading installation instructions and configuring the server. Unfortunately, today's web apps employ various package managers, languages, and frameworks, making this procedure time-consuming and difficult. Also, DNS and SSL certificates must be configured when the programme is installed. Finally, if the server hosts several apps, it is necessary to ensure that they do not interfere.

Cloudron will resolve and automate all of the difficulties mentioned earlier with a single click, allowing non-techies to focus on their company rather than technical issues. For example, if you are a blogger who prefers to install WordPress, SSL, and updates as a non-techie, Cloudron can handle it on your behalf so that you may focus on writing blog posts.


Cloudron requirements

  • A new installation of Ubuntu Focal 20.04 (x64)

  • Minimum of 1GB of RAM and 20GB of disc space.

  • Cloudron default ports: 22 (ssh), 80 (http), 443 (https), 25 (SMTP), 587 (MSA/STARTTLS), 465 (MSA/TLS), 993 (IMAPS), 3478 (STUN server), 5349 (TURN server), 50000 - 51000 (TURN server communication ports), 53 (GitLab), 7494 (OpenVPN) and 4190 (WebSieve)

Step - 1. Profile

  • In the Cloudron interface, Navigate to the settings(drop-down) menu on the top right side and click on the profile option to modify or update administrator profile, applications temporary password, API token credentials.

Cloudron, profile, app passwords, enable 2FA, change password
Cloudron - Interface
  • In the profile interface, users can update the basic and advanced settings such as administrator avatar, changing the display name of the administrator, changing primary email, Changing password recovery email address, and resetting the admin password.

  • Tips:

  • Username: It is not possible to modify the username. To change the username, remove the old one and replace it with a new one.

  • Primary email: This is the email address that apps are assigned. This email address may be used by apps to send notifications to the user. Again, this can be configured to a Cloudron-hosted email account.

  • Password recovery email: The email address to which Cloudron password resets are issued.

How to enable Two-Factor Authentication to Cloudron(2FA)?.

  • To enable Activate Two-Factor Authentication to Cloudron, Click on the "Enable 2FA" option under the basic settings.

Cloudron, two-factor authentication, token, QR
Cloudron - 2FA
  • Use Google Authenticator (Android, iOS) tool to scan the code, type the Google Authenticator code in the Token field, and click on enable to activate two-factor authentication.

Cloudron, username, password, 2FA token, google authenticator
Cloudron - Login with 2FA
  • Finally, Log out of the session and re-login to Cloudron using your username, password, and Google Authentication code.

How to disable two-factor authentication?.

  • By clicking on the Disable 2FA button, users can disable 2FA.

How to assign a temporary password to the apps?.

  • In desktop, email, and mobile clients, app passwords can be used as a security measure. For example, if you are testing a new mobile app from an unknown vendor, you can create a temporary password that allows a single app. This prevents your primary password from being hacked.

  • To create a new app password, click the 'New Password' button:

Cloudron, app password, app temporary password, generate password
Cloudron - App Password Interface

  • Lastly, Type the App password name and choose the application you prefer to apply a temporary password to; click on Generate Password.

  • Tip: Before setting a temporary password for any app, you must install it from the appstore. The temporary app password will not work if no apps are installed. To view the installed apps, go to the dashboard or choose my apps option at the top of the page.

  • Finally, use the copy-paste temporary application password to log in.

How to delete a temporary application password?.

  • You can remove the password from the password list by doing the following:

Cloudron, temporary password, delete password
Cloudron - Temporary Password

How to enable RESTful API?.

  • Cloudron offers a RESTful API for managing all system components, such as adding users, setting groups, and installing apps.

  • If you are an app developer, the Cloudron CLI tool defines a workflow that enables you to create apps for your Cloudron. To learn more about API, visit the link below.

  • https://docs.cloudron.io/api.html

  • By clicking New API Token on the Profile page, you can create Cloudron API tokens.

Cloudron, API token, new API token, security
Cloudron - API Token
  • Finally, copy and paste the new token into your favourite programming language to control the Cloudron.

Revoke API Token

  • You can withdraw the API token and remove access from any portion of the code or programme by clicking the delete button.

Cloudron API, Revoke
Cloudron - Remove API

Step -2. Branding.

  • In the Cloudron interface, Navigate to the settings(drop-down) menu on the top right side and click on the branding option to modify or update Cloudron name, logo, and Footer elements.

Cloudron, name, logo, footer, markdown
Cloudron - Branding Interface

  • The Branding view allows you to edit several features of the Cloudron, including its name, logo, and footer.

  • Lastly, Type your Cloudron name.

Tip: Your Cloudron name will appear in Email layouts for user invitations and notifications, the Dashboard header and navbar, and the Login page.


How to update the Logo?.

  • In the Branding view, click on the logo to alter the Cloudron Logo

  • Finally, upload your logo and save it.


How to change footer content or remove footer of cloudron?.

Cloudron, footer, markdown, style
Cloudron - Footer Branding
  • Example:

&copy; %YEAR%  &nbsp; [Incapio Organization] (http://www.incapio.org) &nbsp; &nbsp; &nbsp;  [Support <i class="fa fa-book"> </i>] (https://kb.incapio.org)

Conclusion:

Here are some more setup options that are recommended for beginners.


 

248 views0 comments

Do you need assistance? Visit Forum to join the conversation.