Changing Your App Name

Last Updated October 2014

Every application on Pagoda Box has its own unique name assigned during the app creation process. The name is either specified by the app's creator or, if no name is provided, is automatically generated. Changing your app's name is a simple process, but there are some things you should be aware of. This doc walks through some the changes that take place when an app name is changed and what it means for you. After reading it, you should be familiar with:

  • How to change your app's Name
  • What to watch out for when changing your app's name

Video Overview

Changing Your App's Name

To change your app's name, go to the Admin tab of your app dashboard. Click into the app name text-box, modify your app name and save your changes.

Things to Know

Whenever you change your app name, there are a few other things that change as well. These could disrupt your workflow and potentially keep your app from working properly.

Your Git Clone URL Changes

Once your app name is changed, your Git Clone URL changes as well. You will need to update the clone URL tied to your pagoda remote. If you don't, whenever you try to push to it, you'll get an error saying that you aren't a collaborator on the app.

Updating Your Pagoda Remote Terminal

  # update your pagoda remote with your new clone url
  $ git remote set-url pagoda git@git.pagodabox.io:apps/new-app-name.git

Your App's Live Pagoda Box URL Changes

Your app's name acts as the subdomain in your live Pagoda Box URL (app-name.gopagoda.io). Whenever you change your app name, you change your app's gopagoda.io url. This will affect any functionality within your app that depends on the base url. If these dependencies aren't properly updated, your app will mostly like start throwing errors.

If you have any questions, suggestions, or corrections, let us know.