This guide allows you to quickly use the essential functions of your new Cloud Server.

Install an application

• Create a WordPress website
• Install a Web application (ownCloud, Joomla, Typo3, Drupal, phpBB, Simple Machines Forum, Magento, Prestashop, …)
• Install applications/technologies on Cloud Server (Fast Installer)

Configure the server

• Manage your MySQL databases
• Manage MySQL limits
• Manage your FTP accounts/users
• Manage and publish files on your hosting via FTP
• Modify the resources and configuration

Manage the sites and domains

If your domain name is not managed by Infomaniak or if your hosting is not managed under the same user account as your domain name, refer to this other guide to configure the DNS or records to link the domain name to your hosting. Also:

• Transfer a shared web hosting to a Cloud Server
• Add a site or subdomain to your hosting (multisite)
• Preview your site even if your domain name is not yet pointing to Infomaniak's servers

This guide details how to get started with Swiss Backup, the backup solution in an independent Swiss cloud.

2 Swiss Backup variants

Infomaniak offers two backup modes depending on what you want to back up:

 

1. CLOUD Backups

Allows you to back up and sync files via the protocols:

• Swift (recommended)
• FTP / SFTP
• S3
• Synology NAS system

with the application of your choice

Cloud Backup Getting Started Guide

2. ACRONIS Backups

Ideal solution for backing up:

• workstations Windows / macOS
• mobiles iOS / Android (iPhone / Samsung, etc.)
• Windows/Linux servers
• websites
• virtual machines VMware, Hyper-V, Virtuozzo...
• Microsoft 365 / Google Workspace spaces...

using the software Acronis Cyber Protect Cloud which will perform automatic and customized backups

Acronis Backup Start Guide

Click here to share a review or suggestion about an Infomaniak product.

This guide allows you to quickly use the essential functions of the Streaming Radio (or broadcast audio, live audio streaming... different terms used to refer to the same technology: sending content "live" or with a slight delay allowing it to be played as it is broadcast).

Set up Radio streams

• Set up the broadcasting of a Streaming Radio stream
• Configure an encoder (example with the application Butt)
• Create an audio player to broadcast the stream
• Add an audio stream relay
• Add a backup audio stream
• Delete a stream

To go further…

• Secure an MP3/AAC or HLS stream with a unique key
• Secure an audio stream by GeoIP restriction
• View listening statistics
• Export the Streaming Radio logs via FTP
• Export the logs to ACPM (France)
• Export the logs to Mediapulse (Switzerland)
• Troubleshoot a broadcasting issue

A question or feedback?

• In case of a problem, please consult the knowledge base before contacting support.
• Click here to share a review or suggestion about an Infomaniak product.

Thank you for entrusting Infomaniak with the hosting of your website.

Preamble

• A web hosting service is a storage space available on a computer, also called a "server," connected to the Internet and managed by a web host, Infomaniak.
• This storage space, made available to professionals and individuals, is used to install websites or other types of tools (CRM, extranet, intranet...) that need to be accessible via the Internet.
• These guides allow you to quickly use the essential functions of your new product, your web hosting, which can host multiple websites.

Where to start?

1. Create a WordPress website
2. Build the site with Site Creator
3. Install a web application (ownCloud, Joomla, Typo3, Drupal, phpBB, Simple Machines Forum, Magento, Prestashop, …)
4. Manage your FTP accounts/users
5. Manage and publish files on your web hosting via FTP Manager
6. Manage your MySQL databases
7. Add a site or subdomain to your hosting (multi-sites/multi-domains)
8. Link another domain name to an existing website (domain alias)
9. Preview your site even if your domain name is not yet pointing to Infomaniak's servers

IMPORTANT: the domain name…

Web hosting, to be visible to the public on the Internet, must be associated with a domain name!

Is your domain name not managed by Infomaniak? Or is it in a different Organization than your web hosting? Then refer to this other guide to configure the DNS or the "A records" in order to link the domain name to your web hosting.

In case of a problem

To resolve an issue, please consult the Web Hosting knowledge base before contacting Infomaniak support.

Click here to share a review or suggestion about a Infomaniak product.

This guide explains how to maintain control over your MP3/AAC or HLS Streaming Radio streams by activating unique key (token) protection to decide, for example, whether a listener can listen to your radio or not.

Introduction

• The principle is simple: with each connection, you will make a request to the Infomaniak API, which will return a unique token with a limited and customizable lifespan. This token will authorize anyone who possesses it to consume the stream during this period.
• You can protect an MP3/AAC or HLS stream independently of each other (the same applies to geolocation).
• Enabling the restriction involves changing the stream configuration, which may take a few minutes to be replicated across the servers.

Protect an audio stream with a unique key

To do this, simply go to the restriction settings and activate token protection on the stream you wish to secure:

1. Click here to access the management of your product on the Manager Infomaniak (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the name of the audio stream in question.
4. Click on Restrictions in the left sidebar.
5. Select HLS if necessary.
6. Click on the action menu ⋮ located to the right of the relevant item.
7. Click on Token Restriction:
   
    

Enable the protection next.

Warning, when you activate this option, access to the stream will be instantly blocked for new connections. Adapt your Players to take into account the restriction, as illustrated in the example below:

Create a Radio API Token

To access the Radio API, you must first authenticate using an application token. This step only needs to be done once. To create this application token, refer to this other guide.

The scope is radio and with unlimited lifetime to avoid having to regenerate a code on a regular basis. Once the token is generated, copy it to paste it into the example below.

PHP usage example

For MP3/AAC or HLS, the code can be quite similar, only the URL called in POST changes in its form.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

We are going to create the token. The URL for creating the token breaks down as follows:

• For an MP3 / AAC stream

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

Example to protect https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac the route will be: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• For an HLS stream

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Example to protect https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 the route will be: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Example for MP3/AAC, make sure to adjust:

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

It is important to note that if this code is generated at the time of page loading, the listener will have "window" seconds to start playing the stream. Beyond this delay, the token will expire, and the stream will no longer be able to be launched unless the page is reloaded. Depending on your needs and use case, it will be necessary to adjust this delay in the best possible way.

You will also need to replace the playback URL of your stream below with the one indicated, while keeping the $token parameter at the end. Finally, display the Player (here a simple html5 tag, but you can of course add any overlay afterwards, the token being passed in the $_GET parameters of the url).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";

This guide concerns UTM tags, or Urchin Tracking Module, tags added to URLs to track and analyze the performance of online marketing campaigns from the Newsletter tool.

Preamble

• These UTM tags, which are optional, consist of specific parameters such as source, medium, campaign, term, and content, which help identify the origin of a link's traffic.
• By using UTM tags, marketers can understand which campaigns generate traffic, which channels are most effective, and which ads or strategies work best, based on data collected by web analytics tools.
• The UTM tags thus allow you to create a match between the links present in your newsletters and the tracking of a tool like Google Analytics on your site.

Enable the UTM feature

To access your Newsletter:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. If necessary, click on the domain name concerned in the table that appears.
3. The interface of the Newsletter appears.

Enable this option in the very first step of creating your Newsletter. You will find three fields allowing you to enter keywords of type utm_parameters:

• campaign source (utm_source)
• campaign medium (utm_medium such as email for example)
• campaign name (utm_campaign = the name of your campaign for example)

So:

1. Fill in the 3 UTM fields in step 1 of Newsletter creation.
2. Insert a link to the URL of your site (the latter must be properly configured and analyzed by Google Analytics, for example) in the body of the Newsletter in step 3.
3. When the reader clicks on it, they will be taken to the URL followed by the terms "?utm_source=...&utm_medium=...&utm_campaign=..." with obviously your keywords in place of "...".

If you enter multiple keywords in these fields, any spaces will be replaced with underscores underscore _.

Later, it is planned to be able to enter dynamic formulas in these fields, such as today's date for example. Also, refer to the article https://news.infomaniak.com/comment-creer-un-objectif-google-analytics.

This guide explains how to optimize the site you manage on a Web Hosting to make it faster and allow all visitors to browse it from the Internet without difficulty, regardless of their connection speed.

The role of the hoster

1. … your hosting server is functioning normally and has not encountered any issues in the last 48 hours.
2. … the network infrastructure has not experienced any disruptions in the last 48 hours.

The role of the site owner and the webmaster

Infomaniak does not intervene in the content of the servers or the development of websites. The creation or maintenance of a site is a different job, although it is related to its activities since the tools and services that a webmaster uses to create websites are offered.

Analyzing the cause of slowdowns

Here is what you should do if you notice slowness with your site:

1. Follow the Google PageSpeed Insights recommendations to optimize your website... The points highlighted concern the design of the website and not the server configuration; refer to this other guide if the test result suggests enabling resource compression on your site.
2. In case of slowness from abroad, consider activating DNS Fast Anycast.
3. Install and configure a cache system on your site to avoid redundant access to databases and speed up the display of your site.
4. Consider a CDN.
5. Test the server's response speed (TTFB).
6. Scan your hosting for viruses.
7. Purge the databases regularly and delete unnecessary entries.
8. Use the latest PHP version compatible with your site/CMS/Web application.
9. Avoid using images, counters, CGI, or media hosted by external providers, as if they are unreachable, your site will seem slow.
10. Disable any unnecessary WordPress extensions that consume a lot of resources in your CMS.
11. Keep your CMS/Web applications up to date regularly.
12. Implement a crawl delay for indexing bots, as some have a very "aggressive" operation; it is possible to limit their impact by implementing a Crawl-delay.
13. Check the possible error-logs which group all the errors generated by your site; by correcting these errors, your site will be more performant.
14. Check the slowlogs: they group the queries that take more than 5 seconds to execute; it is important to correct the queries listed in this file (SQL optimization examples).
15. Add a server cache system like Memcached (Cloud server only).
16. Increase the max_children value (Cloud server only).

If a problem persists...

As a site owner, if you are a webmaster or have hired a webmaster who also cannot find the cause of the slowness, contact Infomaniak support in writing only after obtaining the following information:

1. Hosted site name.
2. Dates and times when slowness was encountered.
3. Name of the database potentially involved / same for FTP account.
4. Your public IP address at the time of the tests (visible for example on https://www.infomaniak.com/ip).
5. Type of slowness observed (site display, FTP transfers...).
6. Issues (such as slowness) accessing the Infomaniak site intermittently?
7. Result of a traceroute to 84.16.66.66 and copy-paste the complete results (screenshot if necessary).
8. Result of a speedtest by choosing Infomaniak as the destination (speedtest.net — click on Change Server to select Infomaniak).

If your needs skyrocket…

If shared hosting no longer suits your site, you should consider moving to a Serveur Cloud. Your site can be easily moved to this type of server where it will be alone and on which you can install a cache engine, for example.

This guide details the limits of Site Creator Infomaniak.

Site Creator Limits

Content

• There is no limit to the number of pages or store articles that can be added with Site Creator.
• The total volume available to you depends on the size of the hosting where the site created with Site Creator is located; a standard Web Hosting plan comes with 250 GB of disk space.
• Also refer to this other guide.

FTP Management

• You cannot access your site's files on the server, neither by FTP nor by any other means than the manager provided by the Infomaniak Manager.

Website Export

• It is not possible to import or export the website (to another host or another hosting plan, for example).
• Themes or modules are not exportable.

This guide explains the differences between the web hosting offers to help you choose the best solution according to your computer needs.

Web Hosting Starter

The free web hosting

The Starter Web hosting is offered for free with each domain name registered with Infomaniak. It provides 10 MB of disk space to create a site (basic pages in HTML language only - no PHP, no database) even without particular knowledge thanks to the Welcome Page tool.

• Register or transfer a domain name with Infomaniak
• Learn more about the benefits included with a domain name

Shared Web Hosting

The flagship offer to create your sites

These web hostings are shared offers (the websites will be hosted on servers whose resources are shared with other customers). To ensure the reliability of these shared services, Infomaniak servers use on average only 40% of the CPU power and are equipped with professional, latest generation SSD disks.

Web hosting offers a minimum of 250 GB of disk space and allows you to manage multiple websites with multiple domain names. This offer includes all the technologies usually used to create professional sites: PHP, MySQL, FTP and SSH access, SSL certificates and easy installation of WordPress or common CMS, etc. It is also possible to add a Node.js site and/or Site Creator.

Cloud Server

Professional Web hosting

With a Cloud Server, the resources allocated to you are not shared with other clients and you can customize the hardware and software configuration of your server according to your needs. A Cloud Server also allows you to use components that are not available on shared web hosting (Node.js, mongoDB, Sol, FFMPEG, etc.).

• A Cloud Server allows you to easily manage your server via the same administration interface as Web hosting - you manage the sites in the same way.
• A VPS allows you to manage your server completely autonomously with the version of Windows or the Linux distribution of your choice (Debian, Ubuntu, openSUSE, ...) - solid technical skills are required to use a VPS, including VPS Lite.

Public Cloud (and Kubernetes Service)

Open, proven, and secure IaaS solution

For Infomaniak, it is the infrastructure that drives kDrive, Swiss Backup and the Webmail, services used by several million users. But Public Cloud is accessible to everyone and provides the resources you need to develop your projects.‍

With customized and tailored offers, you will have no trouble managing your development budget. No setup fees. No minimum amount. Cancelable at any time. You only pay for the resources actually used with Public Cloud at the end of each month, same for Kubernetes Service.

Jelastic Cloud

Web hosting tailored to your chosen technologies

Jelastic Cloud allows you to create custom development environments with the technologies of your choice (PHP, Java, Docker, Ruby, etc.). It is a flexible cloud offering:

• Horizontal and vertical scaling of resources.
• Payment based on actual resource consumption.
• Easy customization of your infrastructure (redundancy, IP, SSL, load balancing, etc.).

This guide details the offer of Serveur Cloud which allows you to create several hostings (FTP "spaces" for which you create your FTP/SSH accounts) on which you add sites (Apache "vhosts" for the indicated domain), and the VPS offer intended for a different use.

Breaking free from shared hosting limitations

With a managed Cloud Server, you can distribute your sites across your hosting environments as you wish. You can configure them by specifying the root directory as well as certain information such as the memory_limit and the max_execution_time beyond the limits imposed by a shared environment.

Web tools are available such as cronjobs, Site Creator, WordPress (which allows for the installation and use of the WordPress tool with ease) or access and error logs. It is quite possible to add a specific Apache module or to install a caching system.

Server Cloud or VPS?

Managed (Serveur Cloud)

Infomaniak manages the software part of the servers under FastCGI and PHP-FPM without allowing you to freely configure the server (for example, no custom installation). Only specific programs can be installed.

Unmanaged (VPS)

Infomaniak handles the hardware and installs the chosen version of Linux or Windows upon order. There is no software-level intervention. The server is under "your responsibility". You can restart the server via the Infomaniak Manager and a snapshot system is available (excluding VPS Lite).

If you are hesitant to take a Server and you mainly plan to have a large amount of video content, you can pair a shared hosting with a VOD space. This solves the problems of overload on a site since it allows you to separate the audiovisual content from your shared hosting and thus have a video storage space that easily supports significant load increases. You will also have detailed statistics at your disposal regarding the viewing of your videos.

Switching from one to the other...

To migrate a **Serveur Cloud** to a **VPS**, or vice versa, there is no "turnkey" solution. For this type of migration, you must cancel the product that is no longer desired and then order the product you need in its place. Infomaniak will refund upon request any purchase of a new server if the cancellation occurs within 30 days of the order.