> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Deploy Magento on Upsun Cloud
> Complete these steps to successfully deploy Magento on Upsun Cloud.
Before attempting to deploy Magento on Upsun, you **must complete the [Getting started guide](https://developer.upsun.com/docs/get-started/here)**.
You can also **check out the [Upsun Cloud demo app](https://console.upsun.com/projects/create-project)** and [Resource configuration guide](https://developer.upsun.com/docs/manage-resources/adjust-resources.md). These provide all of the core concepts and common commands you need to easily follow this Magento guide.
## Before you begin
You need:
- [Git](https://git-scm.com/downloads).
Git is the primary tool to manage everything your app needs to run.
Push commits to deploy changes and control configuration through YAML files.
These files describe your infrastructure, making it transparent and version-controlled.
- An Upsun account.
If you don't already have one, [register for a trial account](https://auth.upsun.com/register).
You can sign up with an email address or an existing GitHub, Bitbucket, or Google account.
If you choose one of these accounts, you can set a password for your Upsun account later.
- The [Upsun CLI](https://developer.upsun.com/cli.md).
This lets you interact with your project from the command line.
You can also do most things through the [Web Console](https://developer.upsun.com/docs/administration/web).
> [!NOTE]
>
> Authentication
> You will not need Adobe Commerce authentication keys for this process but if you would like to learn how to set them up if you want to adjust the Composer repository to [https://repo.magento.com/](https://repo.magento.com/), visit [Adobe Commerce Authentication](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/develop/authentication-keys).
We will be using the [Upsun Cloud Magento example project](https://github.com/platformsh-templates/magentoCE24/blob/main/README) for this deployment process. The example specifically features:
* PHP {{meta_version_php}}
* MariaDB {{meta_version_mariadb}}
* Redis {{meta_version_redis}}
* OpenSearch {{meta_version_opensearch}}
* RabbitMQ {{meta_version_rabbitmq}}
* Automatic TLS certificates
* Composer-based build
The example also features an [Upsun Cloud config.yaml](https://github.com/platformsh-templates/magentoCE24/blob/main/.upsun/config.yaml) file. Below is a **shortened example** of the config.yaml file:
applications:
\:
\# The runtime the application uses.
type: php:\{\{version:php:latest}}
\# Specify additional PHP extensions that should be loaded.
runtime:
extensions:
\- xsl
\- sodium
\- redis
\- blackfire
variables:
env:
NVM\_VERSION: master
NODE\_VERSION: 20
MAGENTO\_DC\_INDEXER\_\_USE\_APPLICATION\_LOCK: true
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOGINVENTORY\_STOCK\_\_SIMPLE: 200
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOG\_CATEGORY\_PRODUCT: 666
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOGSEARCH\_FULLTEXT\_\_PARTIAL\_REINDEX: 100
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOGSEARCH\_FULLTEXT\_\_MYSQL\_GET: 500
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOGSEARCH\_FULLTEXT\_\_ELASTIC\_SAVE: 500
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOG\_PRODUCT\_PRICE\_\_SIMPLE: 200
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOG\_PRODUCT\_PRICE\_\_DEFAULT: 500
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOG\_PRODUCT\_PRICE\_\_CONFIGURABLE: 666
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_CATALOGPERMISSIONS\_CATEGORY: 999
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_INVENTORY\_\_SIMPLE: 210
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_INVENTORY\_\_DEFAULT: 510
MAGENTO\_INDEXER\_BATCH\_SIZE\_\_INVENTORY\_\_CONFIGURABLE: 616
php:
memory\_limit: "512M"
...
## Create project
Copy and run the following command in command line:
`upsun project:create --init-repo https://github.com/platformsh-templates/magentoCE24/`
You will then have to make the following selections:
* Select an organization to create the project under
* Select a title for your project
* Select a [region to deploy from](https://developer.upsun.com/docs/development/regions.md#regions)
* Select your default branch
* Select whether you would like to set your new project as the remote for any existing repositories that have been detected under your organization
Once you have made your selections, the Upsun bot will activate your project.
When your project is created, you will be provided with the following details to access it:
* `Region`
* `Project ID`
* `Project title`
* `Project URL`
* `Git URL`
## Configure resources
Copy the Project URL into your browser. You should see your newly created project in the Upsun console. For example, if you had named your Magento project `Mage`, you would see something similar to the screenshot below:
You will be prompted to configure your resources. At this stage you can select the CPU, RAM, instances and disk size for your Magento project.
### Recommended configurations
You will see that the `container_profile` for the app container is using the `BALANCED` profile by default. The standard CPU & RAM recommendation for your app container is a minimum of `0.5 CPU, 1088MB RAM`. Please see the table below for all **recommended minimum settings for your app container**:
| CPU & RAM | Instances | Disk/storage |
| - | - | - |
| `0.5 CPU, 1088MB RAM` | No minimum | `256MB` |
All other services will be using their [default container profiles](https://developer.upsun.com/docs/manage-resources/adjust-resources.md#advanced-container-profiles) and therefore can be set to `0.1 CPU`, so the above values only apply as recommended minimums for your app container.
Once your project is deployed, you may need to [adjust your resources](https://developer.upsun.com/docs/manage-resources/adjust-resources.md) and [adjust the container profiles](https://developer.upsun.com/docs/manage-resources/adjust-resources.md#adjust-a-container-profile) of your other services.
> [!NOTE]
>
> Note
> Please note that the deployment after configuring resources may take up to 25 minutes.
## View your log
Now that your resources have been configured, you can view a log of how Upsun creates your project. In the recents section, click the three dots to the right of the activity about your `updated resource allocation on Main`.
Below is a **shortened example** of what your log would look like:
Configuring resources
Setting 'app' resources to 0.5 CPU, 1088MB RAM.
Setting 'app' disk to 256MB.
Setting 'db' resources to 0.1 CPU, 448MB RAM.
Setting 'db' disk to 256MB.
Setting 'cache' resources to 0.1 CPU, 352MB RAM.
Setting 'session' resources to 0.1 CPU, 352MB RAM.
Setting 'session' disk to 256MB.
Setting 'indexer' resources to 0.1 CPU, 448MB RAM.
Setting 'indexer' disk to 256MB.
Setting 'queue' resources to 0.1 CPU, 448MB RAM.
Setting 'queue' disk to 256MB.
Building application 'app' (runtime type: php:\{\{version:php:latest}}, tree: 392d8f3)
Generating runtime configuration.
Installing build dependencies...
...
Environment configuration
app (type: php:\{\{version:php:latest}}, cpu: 0.1, memory: 64, disk: 1024)
db (type: mariadb:\{\{version:mariadb:latest}}, cpu: 0.1, memory: 448, disk: 256)
cache (type: redis:\{\{version:redis:latest}}, cpu: 0.1, memory: 352)
session (type: redis-persistent:\{\{version:redis:latest}}, cpu: 0.1, memory: 352, disk: 256)
indexer (type: opensearch:\{\{version:opensearch:latest}}, cpu: 0.1, memory: 448, disk: 256)
queue (type: rabbitmq:\{\{version:rabbitmq:latest}}, cpu: 0.1, memory: 448, disk: 256)
Environment routes
http\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/ redirects to https\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/
http\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/static/ redirects to https\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/static/
https\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/ is served by application \`app\`
https\://main-bvxea6i-g7baduaayq63y.eu-5.platformsh.site/static/ is served by application \`app\`
## Preview your Magento project
Now that your Magento project has been successfully created, you will see the standard Magento layout when you navigate to your preview link:
## Fetch your Magento project locally
First, get your project ID by clicking the three dots in the upper right hand of your console, next to the settings cog wheel. Your project ID will appear in a drop down menu.
Copy the following command into your command line.
`upsun get `
Make sure to replace `` with the Project ID you just copied from console. Once you run the command in command line, you will be asked if you want to set the remote project for any existing repositories to your project. You will also need to specify a directory for your project to be stored in when downloaded.
Once your project has successfully downloaded, you will be able to access it locally by navigating to the directory you chose.
## Further resources
### Documentation
* [PHP documentation](https://developer.upsun.com/docs/languages/php/)
* [Authenticated Composer repositories](https://developer.upsun.com/docs/languages/php/composer-auth.md)
* [Resource configuration guide](https://developer.upsun.com/docs/manage-resources/adjust-resources.md)
### Authentication
* [Composer Authentication and Post Installation Setup](https://github.com/platformsh-templates/magentoCE24/blob/main/README#composer-authentication-and-post-installation-setup)
* [Magento Repository authentication keys](https://devdocs.magento.com/guides/v2.4/install-gde/prereq/connect-auth.html)
### Community content
* [PHP topics](https://support.platform.sh/hc/en-us/search?utf8=%E2%9C%93\&query=php)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.