To make changes to your app’s code and test them without affecting your production environment, set up a local development environment on your computer. For the most effective testing, you want your local environment to match your Upsun environments. The best way to do this is to use a cross-platform tool based on Docker. This ensures the changes you make locally appear as they would on your Upsun environments. It also means you don’t have to worry about configuring your machine with the various dependencies, certificates, and connections your app needs to run. The recommended tool for local development with Upsun is DDEV. The integration with DDEV is maintained by Upsun to ensure it works smoothly. If you choose to use DDEV, follow the steps on its page. Otherwise, follow these steps to run your app on your computer.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.
Before you begin
You need to have:- An Upsun account: new users can register here
- A working project
- Git
- The Upsun CLI
1. Get your code
If you don’t have your app code on your computer, download a copy.-
Get your project ID by running
upsun projects. -
Get the code by running the following command:
Or pull from your integrated Git repository.
.upsun/config.yaml/local directory that’s excluded from Git.
It contains builds and local metadata about your project.
You can now make changes to your project without pushing to Upsun each time to test them.
Instead, you can locally build your application using the Upsun CLI.
Note that if your app contains services, you need to open an SSH tunnel to connect to them.
For more information, see how to connect services.
2. Connect to services
If your app requires services to run, you have two options for developing locally:- Tethered local development involves running your app on a local web server but keeping all other services on Upsun and connecting to them over an SSH tunnel.
- Untethered local development involves running your entire site locally, including all services.