Skip to main content

Quickstart

Deploying your application with mogenius is easy. We'll walk you through the first steps to get your service up and running in the cloud, and you can get back to coding in no time.

1. Sign up​

First you will have to sign up - Enter your email address and choose a password.
Next, verification of your email address and phone number is required to sufficiently secure your mogenius account.
Done? Great! You are now ready to create your first cloudspace.

Sign up

2. Create a Cloudspace

Start your first project on mogenius by creating a cloudspace. Set a name for your cloudspace with a maximum length of 24 characters without spaces and special characters.

enter image description here

Your hostname

The hostname is automatically filled in, depending on your cloudspace name. This hostname is the personal domain of your cloudspace and points to the root level within your production stage. You get a hostname for each service and stage in your cloudspace, and depending on the design of your application, you can choose which hostname to use with your own domain.

Select a plan

You can always start with a free plan to take first steps and test around as long as you like. You can always upgrade to a higher plan with more capabilities later. Click "Create now" and your cloudspace will be created on the free plan.

🥳 Congrats on creating your first cloudspace on mogenius

3. Manage and add stages

The first thing you will see in your cloudspace is the dashboard. It contains all the information you need to keep track of your application in the cloud. You will see here that a production stage has been automatically created. You can add more stages, for example, a development stage. For more information about stages, see here.

4. Add your first service

Take a look at the Stages & Services page. It gives you an overview of the resource consumption and state of each service and stage. As you can see, it is still empty, but we will quickly change that by starting your first service. There are two ways to do this.

1. Start from scratch with a template

services

Choose the service you would like to deploy from the service library.

Connect Github

First, you need to connect Github to your mogenius account. Follow the instructions from Github and authorize mogenius to access your repositories. Once you have granted access, you will see a repository selector. When you create a service, the config files for that service are moved to an empty repository in your Github account, so you can start working on the project immediately. Therefore, either select an empty repository from the drop-down menu that contains only a readme file, or create a new repository.

General settings

Now give your a service a name (this is used to create a hostname, following the pattern service_name-stage-cloudspace_name-id.mogenius.io).

For now, you can leave all other settings at default and create the service. For more information and advanced settings, read more about resource management.

That's it! ⬇️ Jump to deploying your service

2. Use Docker to connect your application

To launch an application that you have already developed or that is in progress, you can select Dockerfile from the service library. Now you have two options to connect a repository: via GitHub or through a public repository.

Connect Github
You need to connect Github to your mogenius account. Follow the instructions from Github and authorize mogenius to access your repositories. Once you have granted access, you will see a repository selector.

Use a public repository Set the repository toggle to "Public". Now paste the HTTPS url of a public repository into the corresponding field.

Select your repository from the dropdown menu or search for it in the input field. Note that mogenius will look for a Dockerfile inside the given directory so make sure your repository contains one. When you have selected the repository with a Dockerfile inside, specify the branch that you want to use.

General service settings

The form fields can be filled in as described below:

Input fieldComment
NameThe name of your service. This will be used to display the service in your cloudspace and the hostname of the service.
Dockerfile nameThis setting has no effect at the moment. You can leave it as is.
Internal PortThe port that your application provides as defined in the Docker file in your repository.
ExposeThis setting has no effect at the moment. You can leave it as is.
StageThe stage you want your service to be deployed in.
Deployment strategyRecreate: Your service is recreated once you deploy a new version (see CI/CD pipeline) with a short downtime while the deployment is running.
Rolling: The service is deployed without interruption. Check out plans for the availability of rolling deployments.

Environment variables

If you need environment variables in your application, you can set them here. They are stored in your Key Vault.
Read more about Environment variables and secrets.

Resource limits

Please review these settings before you start your service, as the default settings may not be sufficient for your application. The specific resources required for deployment depend on the design and usage of your specific service. For orientation you can view the mogenius preconfigured services and their resource settings for reference.

Read more about resource management.

Deploy your service

When all settings are done, you can click "Create service" and your service will be started. In the background, your service will be created and deployed with the allocated resources in a Kubernetes cluster and the Cloudflare CDN including SSL will be set up. Your service will be up and running in less than 5 minutes and you can start working with it immediately.

What's next?

  • You can now start coding! Check out the repository that you connected with mogenius. With git push your new code will be built automatically in your cloudspace. Read more about the CI/CD pipeline.
  • Connect your own domain to make your service easily memorable for users.

We are proud to see you launching your first service on mogenius, great job!

info

If you need help, please take a look at our Help & Feedback page. You can connect with the mogenius community or contact us diretly if you encounter any problems.