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

How do I set up Cloudron on Google Cloud Platform (GCP)?

Updated: Jan 28

Prerequisites

You will need the following items to complete this tutorial:

  • A server running Ubuntu 20.04 with root access. A domain name is required for DNS installation. If you use a domain like incapio.com, Cloudron will install its dashboard at my.incapio.com and the apps at subdomains you specify, such as docs.incapio.com, blog.incapio.com, and so on.

  • Cloudron will use DNS API keys to automate DNS. Cloudron works with a wide range of DNS providers. In this tutorial, we will use GoDaddy DNS. You can generate a GoDaddy DNS API key by following the steps in How to Create a Personal Access Token.

Introduction

Cloudron is a cloud application platform that enables the creation of applications with a single click. Their 80+ stable apps have been thoroughly tested and approved for smooth operation. Everything from database configuration and DNS record setup to certificate installation and management is automated. Cloudron offers a centralised platform for managing users and online apps directly from your web browser.

Step - 1 - Create a Virtual Machine

  • Log in to Google cloud console to view the dashboard, click on the navigation menu, scroll down over to the Compute Engine and choose VM instances.

  • Next, click on "create instance" to launch a new virtual machine and type the instance name, Please note this field is case-sensitive, then choose the region you prefer to launch VM instance, and then choose the zone and machine family, series, and type.

  • Scroll down until you notice boot disk, and click on change the boot disk, then select the operating system to Ubuntu and select the version to 20.04 LTS also increase the disk size to 25 GB and click on "select " to finalize the boot disk.


  • Scroll down to the bottom and click on the networking, disk, security, and management option to expand and expand the networking options and add a network tag.


  • Provide a name, for example: "cloudron-firewall", scroll down to the network interface, and expand the default field to edit network interfaces, Beneath the external IP, click on the drop-down and choose to create an IP address for the virtual machine instance.


  • Then scroll down to the bottom of the page and click on create to deploy the virtual machine instance.

  • Usually, virtual machine deployment takes a few seconds; once it is done, We can notice the status information of the virtual machine, such as name, zone, internal IP, and external IP and so forth.

Step - 2 Create a firewall rule.

  • Navigate to VPC Network, and click on the firewall option under the VPC network to create a firewall rule, and click on create a firewall rule, and type cloudron-ingress, scroll down until you notice the targets section. Select Specified target tags to apply the firewall rules only to your cloudron instance within the virtual network, and type the network tag, and type the source IP range,

  • Also, beneath the protocols and ports, select specified protocols and ports and check the TCP, UDP field to apply port addresses.


Ingress

TCP

22,222,80,443,2525,587,993,3478,4190,5349

UDP

​53,3478,5349,5000-51000

  • Please copy the ports, and paste them in the port field next to the TCP and UDP, and, Finally, click on the "create" option to apply a new ingress firewall rule.

  • Next, click on the create a firewall rule option to add secondary firewall rule to our virtual machine and provide a name; For example, cloudron-egress, and scroll down, under the direction of traffic, choose egress option, then type the network tag, also, type destination IP ranges, and choose to allow all option under the protocols, then click on create to apply a new egress firewall rule to our virtual machine.

Step - 3 Install Cloudron on the Compute Engine

  • Navigate to the virtual machine instances interface, and click on the cloudron SSH option to launch the secure shell access and type "sudo su -" and hit enter to switch to root user.

  • Run the following commands on the terminal:

wget https://cloudron.io/cloudron-setup 
chmod +x cloudron-setup 
./cloudron-setup
  • It will take about 10 minutes to set up. When the setup is finished, the script will ask for your permission to reboot the server; select Y to proceed:

Output

##############################################
         Cloudron Setup (latest)
##############################################

 Follow setup logs in a second terminal with:
 $ tail -f /var/log/cloudron-setup.log

 Join us at https://forum.cloudron.io for any questions.

=> Installing software-properties-common
=> Ensure required apt sources
=> Updating apt and installing script dependencies
=> Checking version
=> Downloading version 6.3.6 ...
=> Installing base dependencies and downloading docker images (this takes some time) ...
=> Installing version 6.3.6 (this takes some time) ...
=> Waiting for cloudron to be ready (this takes some time) ....

After reboot, Visit https://<IP> and accept the self-signed certificate to finish setup.

The server has to be rebooted to apply all the settings. Reboot now ? [Y/n] Y

  • After installing Cloudron on your server, you can configure your domain and administrator account.

Step - 4 Initial Setup

  • In this step, you'll use the setup wizard to configure Cloudron's primary domain and set up your Cloudron account for access. You'll also need to provide Cloudron with your GoDaddy API keys in order for Let's Encrypt to secure your domain.

  • After the server has rebooted, open your browser and navigate to https://your-server-ip/ and accept the self-signed certificate.

  • Accepting the self-signed certificate in Chrome is as simple as clicking Advanced and then Proceed to your-server-ip (unsafe). 



The Cloudron setup wizard will appear at this point. Type a domain name and a hosting provider. Despite the fact that Cloudron supports a wide range of DNS providers, including Cloudflare, Gandi, and GoDaddy, the examples in this tutorial will use GoDaddy as the DNS provider.

Generate GoDaddy API Keys: https://developer.godaddy.com/keys

Enter your GoDaddy API tokens and press the Next button.

Cloudron will use these keys to configure your domain's DNS and obtain Let's Encrypt certificates. Cloudron will take you to https://my.yourdomainname.com. The address bar of your browser will display a green lock to indicate that your connection to your Cloudron installation is now secure. Provide a admin username and password to complete the setup.

After you've created an Administrator account, you'll see the No apps installed yet! screen. Next, click on the app store to log in. If you already have a cloudron account, sign in, otherwise create a new account, and accept the cloudron license, then choose intended use and click on login. Then you can choose which apps to install.

286 views0 comments

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