Skip to main content

Installation

Create your first runner in 3 minutes.

Creating Your Account​

To start using Cloud-Runner, you'll need to create an account. Follow these simple steps:

  1. Visit the Signup Page: Go to app.cloud-runner.com.
  2. Fill Out the Form: Enter your name, email address, and create a password.
  3. Verify Your Email: Check your inbox for a verification email from Cloud-Runner. Click the link in the email to verify your account.
  4. Log In: Once verified, log in to your new Cloud-Runner account.

Creating Your First Runner​

To create your first runner, you'll need several pieces of information:

Choose Your Instance Type​

Cloud-Runner offers two types of instances. Select the one that best fits your needs:

  • Starter:
    • Price: 19€/month
    • Specifications: 4 vCPU, 8GB RAM, 30 minutes of jobs timeout, 4 max concurrent jobs, dynamic IP address.
  • Launchpad:
    • Price: 49€/month
    • Specifications: 8 vCPU, 16GB RAM, 60 minutes of jobs timeout, 8 max concurrent jobs, static IP address.
  • Booster:
    • Price: 89€/month
    • Specifications: 16 vCPU, 32GB RAM, 120 minutes of jobs timeout, 16 max concurrent jobs, static IP address.

Choose Your Executor Type​

Next, decide on the type of executor you want to use for your runner:

  • Docker: Ideal for containerized applications, providing isolation and scalability.
  • Kubernetes: Suitable for more complex, multi-container applications that require orchestration and management.

Find Your GitLab Instance URL and Authentication Token​

You'll need your GitLab instance URL and a registration token to set up your runner. Here's how to find them:

Steps to Locate the GitLab Instance URL and Registration Token​

  1. Access GitLab: Use your GitLab login information to access your GitLab account.
  2. Access the Project: Find the project you want to register the runner for by navigating there. Click on its name in the GitLab dashboard.
  3. Navigate to CI/CD Settings:
    • Click "Settings" in the left-hand menu on the project screen.
    • Select "CI/CD" from the submenu.
  4. Create a Registration Token:
    • Scroll down to the "Runners" section on the CI/CD settings page.
    • Click the "Set up a specific Runner manually" button. The registration token for your project will be displayed.
    • Keep a copy of the registration token in a secure place.
  5. Find the GitLab Instance URL:
    • Look in your web browser's address window for the GitLab instance URL. It should be visible there.
    • If you are unsure of the URL, go to the dashboard of your GitLab account, where the information will be shown.

Once you have the GitLab instance URL and registration token, you can provide us with this information to create your runner.

note

When you create a runner, you will receive two emails:

  1. Instance Creation Email: This email will inform you that your instance is being created.
  2. Runner Ready Email: This email will notify you when your runner is fully operational and ready to use.

Need Help?​

In case you encounter any issues, you can refer to our Top 10 Common Errors page. If you still need assistance, don't hesitate to contact our support team.

  • Email Support: Reach out to us at support@cloud-runner.com. We'll get back to you as soon as possible to assist with your query.

Now that your runner is in production, it's time to configure it for your specific needs. For detailed instructions on configuration, refer to the next page.