For sites already migrated to Upsun.

1. If you've done this for one site already, skip to step 6.
2. Install Docker Desktop. Docker Desktop is a container manager. It governs transactions between containers and the operating system.
   1. https://docs.docker.com/desktop/setup/install/mac-install/
   2. Launch Docker Desktop from the Applications folder.
3. Install DDev. Creates Docker containers and provides interfaces to them. 
   1. brew install ddev
4. Install mkcert — a simple tool for making locally-trusted development certificates. 
   1. mkcert -install
5. Install Upsun CLI.
   1. https://developer.upsun.com/cli
6. Create a directory for your local.
   1. mkdir path/to/hosting/directory/site-name
   2. cd site-name
7. Pull Upsun project files. This will install the stage environment into a directory named stage.
   1. upsun project:list to get project list. This may prompt you to login to the Upsun console. If you get access errors, log in explicitly with upsun login.
   2. Copy ID for site-name.
   3. upsun get -e stage ID stage
   4. cd stage
8. Add GT remote to the local repository. This allows pushes to both the GT enterprise Github and Upsun’s git repositories.
   1. git remote add origin repo-URL
9. Install Composer-managed files and regenerate class loader.
   1. composer install
   2. composer dump-autoload
10. Initialize the DDev environment:
    1. ddev config
       1. Project name: local.site-name.gatech.edu
       2. Docroot location: web
       3. Project type: drupal11
11. Pull database from Upsun.
    1. ddev pull upsun --skip-files
    2. Alternately, you can ddev pull upsun if you want all the files in /sites/default/files but be warned, this can be very time-consuming and can eat up vast amounts of space on your hard drive.
12. Start DDev.
    1. ddev start
    2. When the start process is complete, you can navigate to your local at https://site-name.gatech.edu.ddev.site.

DDev shutdown

1. ddev poweroff is the simplest way to shut down all running containers. You can also simply do ddev stop in the directory of a DDev project to shut down the one. 
2. If your sites are hosted in an external harddrive, you will need to then quit Docker Desktop to eject the drive. Otherwise the mutagen agent (which synchronizes changes between the container and the native filesystem) will prevent the drive from being ejected. Note that if you do these steps in the reverse order (first quitting Docker Desktop and then powering off DDev), the mutagen agent may hang, requiring a force quit.