Exporting data
Back to home
On this page
As a Upsun user, your code and data belong to you. At any time, you can download your site’s data for local development, to back up your data, or to change provider.
Before you begin
You need:
1. Download your app’s code
Your app’s code is maintained through the Git version control system.
To download your entire app’s code history:
-
List all your projects by running the following command:
upsun projects
-
Retrieve the project you want to back up by running the following command:
upsun get PROJECT_ID
2. Download your files
Some files might not be stored in Git, such as data your app writes in mounts.
You can download your files using the CLI or using SSH.
3. Download data from services
The mechanism for downloading from each service (such as your database) varies.
For services designed to hold non-persistent data, such as Redis or Solr, it’s generally not necessary to download data as it can be rebuilt from the primary data store.
For services designed to hold persistent data, see each service’s page for instructions:
4. Get environment variables
Environment variables can contain critical information such as tokens or additional configuration options for your app.
Environment variables can have different prefixes:
- Variables beginning with
env:
are exposed as Unix environment variables. - Variables beginning with
php:
are interpreted asphp.ini
directives.
All other variables are part of $PLATFORM_VARIABLES
.
To back up your environment variables:
-
Get the variable’s values by running the following command:
upsun ssh -- 'echo $PLATFORM_VARIABLES | base64 -d | jq'
Note that you can also get all the environment variable values by running the following command:
upsun ssh -- env
-
Store the data somewhere secure on your computer.
What’s next
- Migrate data from elsewhere into Upsun.
- Migrate to another region.
- To use data from an environment locally, export your data and set up your local development environment.