diff --git a/docs/ecommerce-applications/magento-2/how-to-configure-remote-storage-for-magento-2-x.md b/docs/ecommerce-applications/magento-2/how-to-configure-remote-storage-for-magento-2-x.md index bd56c277..9cb304c6 100644 --- a/docs/ecommerce-applications/magento-2/how-to-configure-remote-storage-for-magento-2-x.md +++ b/docs/ecommerce-applications/magento-2/how-to-configure-remote-storage-for-magento-2-x.md @@ -32,6 +32,19 @@ bin/magento setup:config:set system/media_storage_configuration/media_storage 0 If you're using Hypernode Object Storage or a different provider than AWS S3, you need to specify the `--remote-storage-endpoint` option. +For Hypernode Object Storage, use `main` as the bucket name and `EU` as the region. You can retrieve the remaining parameters by running `hypernode-object-storage info --with-credentials`. + +```console +app@abcdef-example-magweb-cml:~$ hypernode-object-storage info --with-credentials ++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ +| UUID | Name | Plan | Hypernodes | Management URL | Access Key | Secret Key | ++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ +| 12345678-9012-3456-b7e3-19ab43df4a23 | testappbucket1 | OS200GB | testapp | https://example.ams.objectstore.eu | abcd1234 | 1234abcd | ++--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ +``` + +If you're using a different object storage provider, replace these values with the relevant details from your provider. + ```bash bin/magento setup:config:set \ --remote-storage-driver="aws-s3" \ @@ -42,18 +55,33 @@ bin/magento setup:config:set \ --remote-storage-endpoint="https://my-s3-compatible.endpoint.com" ``` -For Hypernode Object Storage, use `main` as the bucket name and `EU` as the region. You can retrieve the remaining parameters by running `hypernode-object-storage info --with-credentials`. +Running the Magento object storage command may not include all necessary settings in the configuration. -```console -app@abcdef-example-magweb-cml:~$ hypernode-object-storage info --with-credentials -+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ -| UUID | Name | Plan | Hypernodes | Management URL | Access Key | Secret Key | -+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ -| 12345678-9012-3456-b7e3-19ab43df4a23 | testappbucket1 | OS200GB | testapp | https://example.ams.objectstore.eu | abcd1234 | 1234abcd | -+--------------------------------------+----------------+---------+-------------+-------------------------------------+---------------+---------------+ +If you're using Hypernode object storage, you need to add the following parameters to your env.php to complete the setup: + +```php +'use_path_style_endpoint' => true, +'path_style' => true, ``` -If you're using a different object storage provider, replace these values with the relevant details from your provider. +The complete and functional Magento configuration should resemble the following example: + +```php +'remote_storage' => [ + 'driver' => 'aws-s3', + 'config' => [ + 'endpoint' => '', + 'bucket' => 'main', + 'region' => 'EU', + 'use_path_style_endpoint' => true, + 'path_style' => true, + 'credentials' => [ + 'key' => '', + 'secret' => '' + ] + ] +], +``` **AWS S3**