Skip to Content

Installing Cloudmox

PreparationInstallation of serverThe installationFirst access: Create administratorEnable two-factor authentication (2FA)You are done!

Preparation

From a blank server to your first login. Built for someone who has never installed anything like this: copy, paste, follow in order. Each step is one click or one command.

For this installation, we use the domain demo.cloudmox.eu everywhere a domain is asked. Replace that with your own domain..

  1. Make sure yo are able to get a server with the minimal server requirements
  2. If you have them available for installation, get the ipaddresses that you server will get (IPv4/IPv6)
  3. Have administration access to your Proxmox
  4. Make sure you are able to allow traffic from the new Cloudmox server to you Proxmox admin panel (usually port 8006)
  5. Have an 2FA app available.  For 2FA, we use the universal OAuth. You may already have an app. Otherwise, you can use one of the ones below:
    Apple

Golden rule: the panel only opens on a domain that points to the VPS. The HTTPS security certificate is issued at installation. That will fail if DNS is not set before installation!


Installation of server

  • Install the Ubuntu or Debian server with only SSH and optionally server tools. No Apache, databases or desktop.
  • Get the public IP of your server.
  • At your DNS provider, you create an A (IPv4) and AAAA (IPv6) record with the name that Cloudmox will use and the public IP-address. If you domainnname is cloudinventor.eu, then you could use demo.cloudmox.eu. Thus cloudmox.[youdomain].[tld].
  • Check the firewall settings. Especially inbound port 22, 80 and 443 should be open to the world for a succesfull installation
  • Login to you server with SSH and the SSH password you got when installing the server:
ssh root@demo.cloudmox.eu

This should work. If it says someting like ssh: Could not resolve hostname, then check if DNS is populated via a tool like https://mxtoolbox.com/DnsLookup.aspx

If that shows that it works, you are all set. Ten you can do

ssh root@[ipaddres of server]


Some installations do not allow SSH access as root but only a user with less rights then root. For example debian. In that case, login with ssh debian@ in stead of root@. Once logged in type: sudo su, to switch to root.

nsert text styles like headers, bold, italic, lists, and fonts with a simple WYSIWYG editor. Flexible and easy to use, it lets you design and format documents in real time. No coding knowledge is needed, making content creation straightforward and enjoyable for everyone.


The installation

If you are logged out from you Cloudmox server, login again. Change the command below by replacing demo.cloudmox.eu to your domain. Copy it and paste in on the command line of you Cloudmox server as root. 
It downloads the installer, installs Docker if missing, downloads the package and brings everything up.

wget -qO- https://portal.inov.global/downloads/get-cloudmox.sh | sudo DOMAIN=demo.cloudmox.eu PKG_URL=https://portal.inov.global/downloads/cloudmox-3.0.0.tar.gz RESELLER_NAME="Your Company" LICENSE_SERVER=https://portal.inov.global bash

Paste the command as one single line (do not split it into several lines). Wait a few minutes. At the end, the installer prints the URL and a Setup token, like this:

===================== FIRST ACCESS =====================
URL: https://panel.yourdomain.com
Setup token: cmx-setup-XXXXXXXXXXXX

Copy the Setup token. It unlocks the first administrator registration later on. If the screen scrolls and you lose it, recover it anytime with:

docker exec painel-api-1 printenv SETUP_TOKEN
The installer refuses to run if you do not provide your domain (or if you use an example domain). This is intentional, so you do not install into nowhere


First access: Create administrator

  • You can now surf to your server on the domain you created. Following the example, it would be https://demo.cloudmox.eu. At the bottom you can select a language
  • The Set up the panel screen appears by itself (only the first time)
  • Fill in your e-mail, a strong password (at least 8 characters) and the Setup token that was showed during installation
  • Click Create administrator. The panel logs you in

After you create the first administrator, the registration screen closes forever! Nobody else can register through it


Enable two-factor authentication (2FA)

Right after the first login, the panel requires you to enable 2FA before unlocking the rest. It is mandatory. A QR code is shown to setup 2FA

  • On your phone, open the authenticator app and choose, add code/toke or Oauth. It should show a way to scan a QR code
  • Point the camera at the QR code shown in the panel (or type the manual key next to it)
  • Enter the 6-digit code the app generated into the panel and confirm
  • rom then on, every login asks for e-mail, password and the app code
The super admin can turn the 2fa requirement on or off under My account, Security, Platform security. We recomend to keep it turned on!

You are done!


That was all. You installed Cloudmox.


Next step: Install license