This guide concerns inbound and outbound traffic permissions between different hosts at the database level.

Access...

... to databases external to Infomaniak

From a Infomaniak Web hosting, it is possible to make MySQL queries to external servers without restriction.

... from the outside to the Infomaniak databases

Access to Infomaniak databases from outside the infrastructure is only allowed with a Serveur Cloud (you need to open port 3306 in TCP / inbound in the firewall).

Allow external connections on MongoDB

Regarding MongoDB, you need to disable the local_only option from Fast Installer:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Fast Installer in the left sidebar.
4. Click on MongoDB.
5. Click on the action menu ⋮ to the right of the relevant item in the displayed table.
6. Click on Configure:
   
7. Disable local_only:
   
8. Save the changes.

This guide explains how to activate or deactivate maintenance mode on a website of an Hosting Infomaniak.

Introduction

• Maintenance mode allows you to display a custom message to your visitors, for example while resolving a technical issue.
• It is also possible to specify IP addresses that can bypass this page.
• An email is sent to the users of the Organization.

Enable maintenance mode

To activate a page that temporarily replaces your usual homepage:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click the toggle switch to enable the maintenance page:
   
4. Confirm the activation of maintenance mode.

Customize the maintenance page

To set up a page with your chosen message:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Maintenance Page in the left sidebar.
4. Click on ‍ Create a page or on the Customize button if it already exists:
   
5. Format the text of your choice.
6. Configure the display using the elements on the right.
7. Click on Save to avoid losing your ongoing edits.
8. Click on Save & Activate to publish the page:
   

Allow IP addresses

It is possible to display a site even with maintenance mode enabled. To do this, it is necessary to enter the IP addresses of the computers that need to bypass maintenance mode:

1. Activate maintenance mode according to the procedure above.
2. Go to the maintenance page configuration page (see procedure above)
3. Under Maintenance on the right, click on Insert my IP address to allow your computer to display the site without maintenance mode.
   • It is also possible to manually enter the IP addresses to authorize.
4. Click on Save and publish.

Disable maintenance mode

To disable the message that appears on your site during maintenance:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click either the Disable button or the toggle switch to disable the maintenance page:
   
4. Confirm the deactivation of maintenance.

Alternative method for WordPress

It is not recommended to activate the Infomaniak maintenance page above to then work in WordPress.

It is recommended to install a WordPress extension (there are dozens available) dedicated to maintenance within the CMS itself.

Alternatively, you can add the code <?php $upgrading = time(); ?> to a new empty file named .maintenance (the dot before the file name is important) placed on the server at the root of your site, which will disable all your pages except the WordPress homepage.

This guide explains how‍ to create subdomains on an existing Infomaniak hosting, using a .htaccess file.

Preamble

• The hosting can be on a Shared Web Hosting offer or on a Cloud Server but this function is impossible with a Starter hosting.
• Subdomains can be added very easily to your current hosting since you have 20 sites per hosting (sites = subdomains) included in the base offer.
• If you do not wish to use this available site volume, you can follow the method below.
   

Create a subdomain as a shortcut

The subdomains created in this way help to organize a hosting. For example, the address vlog.domain.xyz will be a shortcut for the address domain.xyz/vlog. In other words, the address vlog.domain.xyz will redirect to the folder vlog which must be located at the root of the website domain.xyz. In this example, vlog is the subdomain of domain.xyz.

1. Add the subdomain as an alias for your website

To do this:

1. Follow the alias addition procedure but please read points 2 and 3 below.
2. In the field to add the linked domain, enter the full address of the subdomain (e.g. vlog.domain.xyz).
3. If your domain or its DNS zone is managed by Infomaniak, enable the following two options: Update the DNS records for this domain and Replace existing entries ; if that is not the case, create a A record with your registrar with the following information:
   • field: the full URL address of the subdomain (e.g. vlog.domain.xyz)
   • target: the IPv4 address (A record) of your site (refer to this other guide to find the A record of your site)

2. Modify the .htaccess file of your website

Using your FTP software/client or the FTP Manager, add and adapt the following code in the .htaccess file located at the root of your website:

RewriteCond %{HTTP_HOST} ^(.*)\.domain\.xyz [NC]
RewriteCond %{DOCUMENT_ROOT}/%1/ -d
RewriteCond %1::%{REQUEST_URI} !^(.*?)::/\1/?
RewriteRule "^(.*)$" "%{DOCUMENT_ROOT}/%1/$1" [L]

Explanation for the third line: https://stackoverflow.com/a/15981056

Replace on the first line:

• domain with your domain name
• xyz by the extension of your domain name (ch, fr, etc.)

Now, the address vlog.domain.xyz should display the content of the vlog folder located at the root of your website. If this is not the case, check that the vlog folder actually exists at the root of your website.

This guide explains how to add or modify one or more A and AAAA type records in the DNS zone (of a domain name) managed on the Manager Infomaniak.

Introduction

• This type of record allows a domain name to point to a static IP address (usually a server), type A for IPv4 and AAAA for IPv6.
• This is the method generally used to redirect your domain name to the IP address of the web server where your website is hosted. Moreover, this type of pointing is used automatically to link your domain name with your website if both are in the same place and in the same Infomaniak Organization.
• You should only modify this type of record if you have a specific configuration to implement (e.g., pointing a subdomain to an external application).

Modify the DNS zone

Refer to this other guide to manage this type of record in a DNS zone.

This guide explains how to modify the server configuration of a site on Web Hosting Infomaniak.

Preamble

• Apache is the HTTP server.
  • It is configured with a .htaccess file placed at the root of the website.
• PHP is a programming language used to create dynamic web pages via an HTTP server.
  • It is possible to customize PHP directives with a .user.ini file, which will be effective in the folders and subfolders of the location of the .user.ini file.
• Refer to this other guide regarding the creation of .htaccess & .user.ini files.

Modify the server configuration of a site…

… via the Manager

To modify the PHP configuration and most of the parameters (max_input_vars, allow_url_fopen, memory_limit, post_max_size + upload_max_filesize, etc.):

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Manage under Advanced Settings:
   
4. Click on the different tabs General, PHP / Apache and PHP Extensions to make the desired adjustments:
   

Refer to this other guide if you are looking for information about limit values and the possibilities of unlocking them.

… via the .user.ini file

For the PHP directives that are not available in the Manager, it is necessary to set the desired values in the .user.ini file, for example:

max_file_uploads = 20

The list of existing directives can be found on the official PHP website but the elements with the indication PHP_INI_SYSTEM in the Modifiable column as well as max_input_time, memory_limit and mysqli.default_socket are not usable.

... in CLI

To customize PHP directives when running scripts via command line (CLI) or in CRON jobs, it is necessary to specify the desired values in a .user.ini file.

Next, to apply these configurations, the PHP executable is used with the option -c followed by the path to the .user.ini file.

For example, to modify the memory limit available for PHP to 1024M, you can create or modify the .user.ini file using the following command:

echo 'memory_limit = 1024M' > .user.ini

This command writes the directive memory_limit with the value 1024M in the file .user.ini.

Then, when running a PHP script via command line or in a CRON job, the PHP command with the -c option will be used to specify the .user.ini file containing the custom configurations.

The following example enables allow_url_fopen for the WP CLI tool (which notably allows retrieving extensions):

php -d allow_url_fopen=On ~/bin/wp package install trepmal/wp-revisions-cli

• php: the PHP executable
• -d allow_url_fopen=On: the option -d allows to set a PHP configuration directive (allow_url_fopen) with the value On
• ~/bin/wp: path to the WP CLI executable
• package install trepmal/wp-revisions-cli: the specific command to install the WP CLI package trepmal/wp-revisions-cli

This ensures that the option allow_url_fopen is enabled during the execution of the specified WP CLI command. Enabling allow_url_fopen may be necessary for certain operations that involve opening remote URLs, such as downloading extensions or packages. Make sure this option is enabled securely and in accordance with best security practices.

This guide explains how to change the URL of your website from the WordPress app installed on your Web Hosting Infomaniak (only in the case where you have installed WordPress via the dedicated tools offered by Infomaniak).

Prerequisites

• The domain name you wish to use must first be added as an alias to the main domain on the relevant site.

Change the address of a WordPress site

To change the address of the site created with WordPress Infomaniak to another domain name that is already in the same Organization:

1. Click here to access the management of your WordPress site on the Infomaniak Manager (need help?).
   • If your site does not appear here, it is because it was not installed via Infomaniak tools… refer to the official documentation.
2. Click directly on the name assigned to the relevant product:
   
3. Click on the action menu ⋮ located to the right of the relevant Web Application.
4. Click on Settings for the application:
   
5. Click on Edit to the right of the WordPress:
   
6. Under Site URL, select the desired web address from the dropdown menu:
   1. If you have not followed the prerequisites above, the desired domain will not appear even if it is registered within the same Organization.
   2. If you have added the domain as an alias for the site, the desired domain will appear and you will be able to select it to replace the previous domain.
7. Click on the Save button:
   

Domain ….preview.infomaniak.website?

Among the URLs present in the dropdown menu, the preview URL allows you to access your WordPress site in case the site's domain name is not yet correctly configured to point to your WordPress app.

This guide explains how…

1. … generate a CSR and private key to request a third-party certificate from a Certification Authority (CA),
2. … import this certificate for your Infomaniak site, using the CRT obtained from the CA.

Preamble

• Although Infomaniak offers all the SSL certificates you might need…
  • free Let's Encrypt certs for personal sites (only possible with sites hosted at Infomaniak),
  • DV certs from Sectigo for professional/private sites that are not registered in the trade register,
  • EV certs from Sectigo for companies registered in the trade register,
• It is also possible to install an SSL certificate obtained elsewhere (intermediate certificate from a certification authority of your choice), custom or self-signed certificates.

1. Generate a CSR (Certificate Signing Request)

A CSR (Certificate Signing Request or Certificate Signing Request) is an encoded file containing the information necessary to request an SSL/TLS certificate.

It must be generated on your side to ensure that the private key remains under your control, using for example OpenSSL.

Adapt and run the following command from a terminal application (command line interface, CLI) on your device:

openssl req -utf8 -nodes -sha256 -newkey rsa:2048 -keyout domain.xyz.key -out domain.xyz.csr -addext "subjectAltName = DNS:domain.xyz, DNS:www.domain.xyz"

Explanations

• newkey rsa:2048: Generates a new 2048-bit RSA key.
• keyout domain.xyz.key: Specifies the file where the private key will be saved.
• out domain.xyz.csr: Specifies the file where the CSR will be saved.
• addext “subjectAltName = ...”: Adds additional domains via the SAN (Subject Alternative Name) extension, necessary to include all desired domains in the certificate (the main domain domain.xyz + any other associated domain or subdomain, such as www.domain.xyz).

After generation, you can check the contents of the CSR with the following command:

openssl req -in domain.xyz.csr -noout -text

This allows you to verify that all domains listed in subjectAltName are correctly included.

Once the CSR is generated, you can send it to the certification authority (CA) to obtain your SSL/TLS certificate.

2. Import the external certificate

Once validated, the CA issues a certificate (domain.xyz.crt) and sometimes an intermediate certificate (ca_bundle.crt). To access SSL certificate management:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on SSL Certificates in the left sidebar.
4. Click the blue Install a certificate button:
   
5. Choose the custom certificate.
6. Click on the Next button:
   
7. Import your certificate and private key, either by importing the .crt and .key files or by copy-pasting.
8. Click on Complete:
   

Alternative command to generate a self-signed certificate (optional)

If you want a local certificate for testing purposes only or without going through a CA (not recommended for production), you can use this command:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout domain.xyz.key -out domain.xyz.crt -addext “subjectAltName = DNS:domain.xyz, DNS:www.domain.xyz”

This generates both a self-signed certificate (domain.xyz.crt) and a private key (domain.xyz.key). However, self-signed certificates are not recognized as valid by public browsers or systems. They are only suitable for internal or development environments.

Import an intermediate certificate

When adding a custom SSL certificate, it is possible to import the intermediate certificate (by importing the .crt file or pasting the data provided by the certification authority):

This guide presents commands that can be executed to test a connection or a network and thus specify the source of a potential error more precisely.

Perform a Telnet...

TELNET allows you to test the connection to a server without considering all the additional settings of a mail or FTP application in order to determine the origin of a problem. If the connection does not go through on an SMTP server, you will need to check, for example, if your firewall is not blocking port 587 or 465.

... on macOS

1. Search for Network Utility.
2. Go to the Ping, Lookup, or Traceroute tab depending on what you want to test.
3. You can also use a Terminal type application (command line interface, CLI / Command Line Interface) on your device and, depending on what you want to test, enter:
   traceroute [server]
nc [server] [port]
   Replace [server] with the server name or its IP address, the same for [port]...

... on Windows

Enable Telnet if necessary.

1. Use a Terminal type application (command line interface, CLI / Command Line Interface) on your device, for example by typing Run then cmd.
2. In the window that opens, depending on what you want to test, type:
   tracert [server]
telnet [server] [port]
   Example: telnet mail.infomaniak.com 587 (allows you to test the SMTP port if your software/email client does not allow sending emails)...

... on Android

1. Use the application Simple Telnet Client which allows you to test very simply via 2 fields to fill in (for example mail.infomaniak.com and port 143 or 993)...

Perform a PING

PING allows you to know if a machine is accessible via the Internet. You can also check with this tool if you are indeed addressing the correct machine, for example during a DNS change, by looking at the IP address obtained. It is possible to perform a ping on a domain name, a hostname or an IP address.

This guide explains how to resolve issues that may occur with a Web Hosting if the latter has undergone modifications at the IP address level (for example, a server move) and your computer retains the old position in its DNS cache.

Flush the DNS cache...

When you visit a website, your computer stores a local association between the domain name and its IP address in the DNS cache. This speeds up the DNS resolution process for future visits to the same site, as the computer can avoid re-consulting the DNS servers to obtain the IP address.

By flushing the DNS cache, you force your computer to query the DNS servers again to obtain the latest up-to-date information on the IP addresses of the sites you visit.

... on Windows

Run the following command from a Terminal type application (command line interface, CLI / Command Line Interface) on your device. Example:

1. Open the Start menu.
2. Type cmd.
3. In the search results, click on Command Prompt.
4. Run the command ipconfig /flushdns.

... on macOS

Run the following command from a Terminal type application (command line interface, CLI / Command Line Interface) on your device:

• Run the command lookupd -flushcache (in case of failure: dscacheutil -flushcache).

... on Linux

Run the following command from a Terminal type application (command line interface, CLI / Command Line Interface) on your device:

• Run the command sudo systemctl restart nscd or sudo /etc/init.d/nscd restart to restart nscd.

Git and GitHub are available at Infomaniak with all hosting offers on…

• … Shared Web Hosting
• … Managed Cloud Server

and of course the Jelastic Cloud offer, which will allow you to deeply integrate versioning.

This guide explains how to change the target folder where your website is stored on an Web Hosting Infomaniak.

Introduction

• On an Infomaniak Web Hosting, it is possible to install several websites with their own domain name (multisite management).
• Each of these sites is stored in a folder of your hosting, which is the target of the site. It is possible to freely modify the target of a site. Example:
  • The site domain.xyz has as target for example the folder /web…
  • You publish a site in a new subfolder of /web named for example /web/v2…
  • By modifying the target /web of the site domain.xyz to /web/v2, the site domain.xyz will display the content of the folder /web/v2 without obviously including this path in the browser's address bar and without leaving access to any files still located in /web.
• It is recommended not to create "v2" in a subfolder of "web" but next to it, by creating the folder at the root of your hosting.
• These folders actually exist on the server, but you are not required to connect via FTP to manage them.

Display the folder of your websites

To find information about the folder where your site is stored:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Then click on the chevron ‍ to expand the Information section of this site.
4. The highlighted indication below is the location of the example site:
   ‍‍

Change the target folder or website folder

To manage the location of a website within the hosting:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Manage in the Advanced Settings section:
   
4. Manage the desired location for the site:
   
5. Click on the button to Save at the bottom of the page.

This guide explains how to force the display of the web hosting name in the browser's address bar to one of the domain names installed as an alias/synonym or how to display the main domain in the address bar instead of the alias.

Limit the "duplicate content" or duplicate content

Suppose you have the hosting votre-domaine.com at Infomaniak and that as an alias domain name you have installed www.domainesyno.xyz.

By default, when you type either of the domain names (votre-domaine.com or domainesyno.xyz) in your browser's address bar, the one you typed will be displayed in the address bar.

You therefore have the possibility to force the display of a different address than the one that was typed. So if someone types domainesyno.xyz, then it is votre-domaine.com that will automatically appear in the address bar.

A code must be entered into a file called .htaccess which must be located at the root of your hosting (in the /web folder of your FTP). If this file does not yet exist, you must create it on the server.

Then insert these directives into the file:

RewriteEngine on
RewriteCond %{HTTP:X-Forwarded-Proto} !https
RewriteRule (.*) https://votre-domaine.com/$1 [R=301,L]

Adjust the code above according to these instructions:

• Replace votre-domaine.com with your domain name with the appropriate extension (.com, .fr, .ch, etc.) that you want to display in the browser's address bar for the visitor. Add www. before your-domaine.com if necessary.
• Replace the second line of the code above with "RewriteCond %{HTTPS} off‍" if a loop error occurs, this means that HTTP/2 is active for this site

Also, familiarize yourself with the automatic redirections to https.

This guide details how to work on a WordPress site with a development environment.

Preamble

• The process can be used at the beginning of a staging process, that is, the creation of a new version of your live website, in a development or testing environment:
  • This allows website owners to test features, security updates, plugins, themes, WordPress updates, and content changes, without risking disruptions or issues on the live site.
  • Once the tests have been conducted and the changes have been validated on the staging copy, it is possible to deploy them to production (on the live site) using automated deployment tools or by making the changes manually.
• Make your life easier! If needed, **local partners recommended by Infomaniak can handle these procedures**. Launch a **free call for tenders**. They take care of everything, freeing you from technical details.

Simple method

To install and set up a new WordPress site with the Infomaniak installer without overwriting your current website:

1. Install WordPress in a second location

Refer to this other guide to create the new site (in parallel with the old site domain.xyz) by assigning it a domain name in the form of new.domain.xyz for example and installing WordPress via Web Applications (Infomaniak WordPress installer).

At this stage, the main site (domain.xyz) remains untouched and you can calmly work on the new site new.domain.xyz. Both function in parallel.

2. Replace the old site with the new one

Once the new site is complete, you can delete the first site to reuse its domain name for the new one:

1. Delete the old site to make the domain name available and reuse it.
2. Add domain.xyz as an alias for new.domain.xyz.
3. Reverse the alias with the main domain.
4. Remove (unlink/delete) new.domain.xyz which has become an alias.
5. As a precaution, check the main URL of the WordPress site via the Web Applications dashboard on the Infomaniak Manager, to ensure it matches the new name, and not the subdomain you had chosen.

Advanced method

To work on an existing WordPress site without modifying its public version, it is recommended to proceed in 3 steps:

1. Duplicate the existing site
2. Work on its copy
3. Change the target directory of the production site to the production environment directory and modify the URLs of the pre-production site according to the domain name of the production site using a WordPress extension or via phpMyAdmin.

1. Duplicate the site to a second location

1. Refer to this other guide to create the new site (in parallel with the old site domain.xyz) by assigning it a domain name in the form of new.domain.xyz for example and installing WordPress via the Applications Web (Infomaniak WordPress installer).
2. Copy your existing site and paste it onto the newly created second WordPress site, using a WordPress extension.

2. Edit the duplicated site

1. At this stage, the main site (domain.xyz) remains untouched and you can calmly work on the new site new.domain.xyz. Both function in parallel.
2. It is recommended to install a WordPress extension (there are dozens available) dedicated to putting the second site into maintenance mode.
3. If you modify the structure of your site and the URLs of your articles/pages change, you can use a free extension like Redirection to automatically create redirects. This will prevent your visitors from encountering 404 pages while search engines reindex your site or if external sites link to your site.

3. Replace the target

1. When you have finished redesigning your site, all you have to do is change the target directory of the production site to the production environment directory and change the URLs of the pre-production site according to the domain name of the production site using a plugin.
2. If you are using a caching extension like WP-Rocket, W3 Total Cache or WP Super Cache, it will be necessary to completely clear all the cache or even disable and then reactivate the plugin.
3. If you continued to modify your site in production during the site overhaul, it will be necessary to retrieve your modifications (articles, media, pages, etc.).
4. After the usual checks (missing images, broken links, etc.), all you have to do is disable the maintenance mode of your site and admire the result.

This guide explains how to change the URL of your site containing a Web Application (such as Prestashop or Joomla) previously installed on your paid Web Hosting offer.

Prerequisites

• The domain name you wish to use must first be added as an alias to the main domain on the relevant site.

Specific guides

Refer to these guides if the application in question is:

• WordPress

Guides for any other Web Application

To change the address of the site created with an Infomaniak Web Application, to another domain name that is already in the same Organization:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned:
   
3. Click on the action menu ⋮ located to the right of the relevant Web Application.
4. Click on Settings for the application:
   
5. Click on Modify to the right of the relevant Web Application address:
   
6. Under Site URL, select the desired web address from the dropdown menu:
   1. If you have not followed the prerequisites above, the desired domain will not appear even if it is registered in the same Organization:
      
   2. If you have added the domain as an alias of the site, the desired domain will appear and you will be able to select it to replace the previous domain:
      
7. Click on the Save button.

Domain ….preview.infomaniak.website ?

Among the URLs present in the dropdown menu, the preview URL allows you to access your site in case the site's domain name is not yet correctly configured to point to your Web Application:

Learn more

• Install or uninstall a Web Application
• Configure the backups of the Web Applications
• Restore a Web Application

This guide explains how to install a new Web Application (Joomla, Drupal, Typo3, PrestaShop, etc.) in a few clicks on the paid Web Hosting offers.

Prerequisites

• Have an Infomaniak Web Hosting (order if necessary).
• Add a blank website to the Infomaniak hosting.

Specific guides

Refer to these guides if you are concerned with the specific installation of:

• WordPress
• ownCloud

Guides for any other Web Application

To access Web Hosting and install a Web Application:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the button Add an app:
   
4. Choose the desired application (if necessary, filter and search).
5. Click on Select:
   
6. Click at the bottom of the page on Next.
7. Enter a name.
8. Leave the default location or choose to install the app in a new folder that you can create using an icon visible to the right of point 8 in the image.
9. Optionally choose to install a previous version if necessary.
10. Click the button Next:
    
11. Configure username and password.
12. Specify certain advanced settings if necessary (backup type in particular).
13. Read and accept the terms of use of the selected app.
14. Click the button Next:
    
15. Confirm the installation of the application in the next step and wait.
    • Take note of any error message on the screen if, for example, the chosen installation folder is not empty or if the PHP version of the site on which you are attempting the installation is not compatible.

Uninstall a Web Application

To access Web Hosting and uninstall the previously installed application:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the action menu ⋮ located to the right of the application to be uninstalled.
4. Click on the trash can icon to delete the application:
   
5. Confirm the deletion.

Learn more

• Modify the domain name associated with the Web Application
• Configure Web Application backups
• Restore a Web Application

This guide offers two methods to access the administration interface of a WordPress site installed via the tools Infomaniak, for example to update the content.

Prerequisites

• Know your access credentials…
  • … to WordPress
  • … to the Manager Infomaniak

Access the WordPress console…

1. … from the Manager

To access WordPress from the Manager:

1. Click here to access the management of your WordPress site on the Infomaniak Manager (need help?).
   • If your site does not appear here, it means it was not installed via the Infomaniak tools… refer to the official documentation.
2. Click directly on the name assigned to the relevant product.
3. Click on the Edit button to open the WordPress login page:
   
4. Enter the username and password chosen during the WordPress installation.

2. ... via the URL /wp-admin

By default, simply add the term /wp-admin to the end of your domain name's URL in your web browser's address bar to access the WordPress console login page directly.

What to do if the shortcut ./wp-admin does not work?

• If the shortcut ./wp-admin does not work, you might be using a security extension that modifies the URL of certain pages to limit attempts to hack your site (example of plugin)…
• If you need to access the WordPress console and your domain name is not functional at the moment, it is possible to switch the main domain name to the preview address..

This guide explains how to run the open source dependency manager Composer 2 using an SSH command.

Preamble

• Composer is an open-source dependency manager for PHP that allows you to define, install, and update the libraries required for a PHP project.
• Composer 1 has been obsolete since 2021 and will no longer allow the installation of new packages or updates since 2025.
• Only version 2 of Composer is now supported and available on all PHP versions from 7.2 to 8.3.

Run Composer 2

Composer 2 is already pre-installed and accessible via SSH. Therefore, there is no need to install it manually.

Simple usage

Log in to your hosting via SSH, then use the following command:

composer

This command will automatically run version 2 of Composer, which is compatible with the PHP version currently in use in your session.

Check the active version

You can check the available version of Composer with:

composer --version

Example output: Composer version 2.5.0 2022-12-20 10:44:08 

Force a specific PHP version

If you want to run Composer with a specific version of PHP, aliases are available. For example:

composer_php8.1 --version

or for example:

composer_php7.4

These aliases allow you to run Composer 2 with the specified PHP interpreter, useful for testing or deploying a project on a target version of PHP.

This guide details the sending of authenticated emails from a website hosted by Infomaniak using an SMTP configuration; the configuration of an authenticated SMTP server is presented for the main CMS.

Preamble

• Using authenticated SMTP for sending emails from your applications offers numerous advantages compared to the standard, unauthenticated PHP mail() function :
  • enhanced security,
  • improved delivery reliability,
  • more precise error handling,
  • optimal compatibility with third-party mail servers,
  • and complete traceability of sent emails.
• Recommended settings:
  • Outgoing SMTP server = mail.infomaniak.com
  • SMTP port = 465 (with SSL)
  • Username = the complete & entire email address ( ? )
  • Password = the one assigned to the email address you are using ( ? )
  • Authentication required for sending emails.

SMTP configuration examples…

Prerequisites

• Have an email service.
  • You have the option to use the Service Mail offered by Infomaniak or any other email service of your choice.

When you have an email address whose domain is attached to your website ( e-mail@domain-site.xyz for example, provide its details to use it for sending via SMTP from the web server:

... on WordPress

1. Log in to the WordPress admin panel.
2. Install an SMTP extension (WP Mail SMTP works).
3. Configure the extension, for example:
   ‍

From then on, an email sent from a contact form present on the site (default form Divi for example, it will be via an SMTP method.

To ensure this, simply check the headers of a message received via this method, notably the line x-mailer which may indicate, for example, WPMailSMTP/Mailer/smtp instead of PHPMailer.

... on Prestashop

1. Log in to the Prestashop admin panel.
2. Go to Advanced Settings then E-mail.
3. Configure sending via SMTP:
   

Then check (to avoid an error like Could not instantiate mail function or sender mismatch) that the address you have configured in these advanced settings matches the address that Prestashop uses for sending. To do this:

1. Log in to the Prestashop admin panel.
2. Go to Store Settings.
3. Click on Contact in the left sidebar.
4. On the Contacts tab, check that the email address mentioned is the same as the one configured previously.
5. Edit the email addresses if necessary:
   
6. Click on the Stores tab.
7. Check (and correct if necessary) that the email address mentioned is the same as the one configured previously:
   

... on Joomla

1. Log in to the Joomla administration panel.
2. Click on System in the left sidebar.
3. Click on Global Configuration:
   
4. Click on the Server tab.
5. Configure sending via the SMTP method:
   

This guide explains how to create a homepage on your Infomaniak website using the welcome page creation tool, a simplified help to create content quickly and easily. To create a more complete site, there is Site Creator.

Prerequisites

• Have a Infomaniak Web hosting (even a simple Starter, the basic Web page to activate if necessary).

Create a welcome page

To access the creation tool:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Page and maintenance in the left sidebar.
4. Check or select the domain name of the site on which you want to install the web page.
5. Click on ‍ Create a homepage or Customize:
   

You can then choose a theme, set the text visible to your visitors, insert an image into the body of the page, manage the SEO content of your page, add a background image, specify social media usernames if necessary, etc. and all of this can be modified at any time.

Click the blue button at the bottom of the page to save and publish your changes.

Note that the tool can be used in conjunction with FTP management of your web hosting if necessary.

Disable and delete the welcome page

To delete the homepage that has been automatically placed at the root of your website's directory:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Page and maintenance in the left sidebar.

You can delete the welcome page using the trash can icon; this will permanently delete the content of the welcome page!
‍

This guide explains how to update a Let's Encrypt SSL certificate for a website hosted by Infomaniak.

Preamble

• It may be necessary, following the addition or removal of aliases to a website, to regenerate a certificate to include the new domain names linked to the website.
• The dashboard will clearly indicate that one of the domains linked to the site is not included in the current SSL certificate:
  
  

Update a Let's Encrypt certificate

To access certificate management:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question:
   
3. Click on the action menu ⋮.
4. Click on Change the certificate:
   
5. Select the type of certificate to update.
6. Click on the Next button:
   
7. Check or select the relevant domains.
8. Click on the button Install: