---
title: "Installation"
manual: "Admiral Cloud Connector"
version: "5.0"
source: "Installation/Index.rst"
modified: "2026-09-15T08:41:54+00:00"
---

# Installation

1.  Install the extension

    Install the extension with composer:

    ```bash
    composer require cpsit/admiral-cloud-connector
    ```

    Afterwards run the following SQL statement:

    ```sql
    INSERT INTO `sys_file_storage` (`pid`, `cruser_id`, `deleted`, `description`, `name`, `driver`, `configuration`, `is_default`, `is_browsable`, `is_public`, `is_writable`, `is_online`, `auto_extract_metadata`, `processingfolder`) VALUES
    (0, 0, 0, 'Automatically created during the installation of EXT:admiral_cloud_connector', 'AdmiralCloud', 'AdmiralCloud', '', 0, 1, 1, 0, 1, 1, '1:/_processed_/');
    ```

    Alternatively you can create the storage manually via list plugin on the root page. Choose *AdmiralCloud*
    from the Driver's list and set "Folder for manipulated and temporary images etc." to *1:/\_processed\_/*.
1.  System configuration

    Once you have set up a contract with AdmiralCloud, you will receive your login credential by mail and SMS.
    Add the required configuration to `config/system/settings.php` or `config/system/additional.php`.

    > [!NOTE]
    > **See also**
    >
    > [Learn more about how configure AdmiralCloud credentials.](SystemSettings.html#SystemSettings)
1.  Initial setup of user groups

    Send a list of your user groups to AdmiralCloud and set up AC SecurityGroups in the backend.

    > [!NOTE]
    > **See also**
    >
    > [Learn more about how to set up user groups.](AcSecGroup.html#AcSecGroup)
1.  Setting up a file mount

    You have to create fileMount "AdmiralCloud" for the storage.

    > [!NOTE]
    > **See also**
    >
    > [Learn more about how to setup the file storage.](FileMount.html#FileMount)
1.  User configuration

    No configuration is needed for editors. Administrators need the Security Group for confirmation.

    > [!NOTE]
    > **See also**
    >
    > [Learn more about user management.](UserConfiguration.html#UserConfiguration)
1.  LinkHandler Configuration

    A LinkHandler configuration is included automatically. No manual configuration steps are necessary.

    You can find the LinkHandler Configuration here: `EXT:admiral_cloud_connector/Configuration/TSconfig/LinkHandler.tsconfig`

## Read more

-   [Setting up the settings for your system](SystemSettings.html#setting-up-the-settings-for-your-system)
-   [Admiralcloud Security Groups](AcSecGroup.html#admiralcloud-security-groups)
-   [FileMount](FileMount.html#filemount)
-   [The user configuration](UserConfiguration.html#the-user-configuration)