Manage Craft assets

Learn how to deploy Craft CMS runtime data to Universal Apps using rsync or SFTP.

Get ready

For best results here, make sure you have completed all steps from the get ready guide. Further, this guide is for advanced users on the Uni Stack already using Git deployment to deploy Craft. You don't need to care about all this, when you have uploaded Craft with SFTP.

About Craft assets

With Craft 3, the assets folder contains files that are managed by the CMS. This is the user generated stuff, uploaded files, mostly images — also see the official Craft docs on that.

The fortrabbit Craft CMS starter .gitignore file excludes /web/assets/* from Git. Why? Because, code and content are separated and the assets uploaded to the App are not represented in Git anyways.

So when you deploy using Git here, the assets must be managed and deployed independently. There are two directions: UP — When you first developed Craft locally, you may want to upload all the images you already have locally to the fortrabbit App; DOWN — When the App is running in production for some time and the clients or editors have created content on the App you want to download that, so your local version is in sync.

Here are your options for doing this with a Universal App:

Manage Craft assets with rsync

We recommend giving rsync on the command line a try. It's easier than you think:

# Sync local assets with remote
$ rsync -av ./web/assets/ {{app-name}}@deploy.{{region}}

Our rsync tutorial covers many useful rsync options, like excludes, --dry-run and --delete.

Manage Craft assets with SFTP

Good old SFTP is another valid way to to do it. Just fire up your SFTP client, login to the App and manage the assets manually. Many SFTP clients are offering sync options, to keep local and remote files up-to-date.

Outsource assets to a cloud storage

This is basically what we are doing with the Object Storage for the Pro Apps: The assets are not stored on the file system of the App any more, once the user uploads files, they get uploaded to an external cloud storage like S3 (or the Object Storage here), within the templates you hot-link all the files to the external storage. This more professional design helps to reduce load on the App. Look out for S3 Craft plugins to get started with this. Use this, when you really need it. Don't over-engineer.

Next steps

Make sure to have your Craft setup correctly. Then tune and optimize.

Further readings

Craft CMS

Install guides

Develop & deploy




Need individual help?
Learn about Company plans ›
Looking for an old article?
See the full list of articles ›
Found an error?
Contribute on GitHub ›