Applications

How to manage application settings

~3 min read

Each application in DeployFly has its own settings page for configuring the domain, PHP version, document root, environment variables, and other per-app options.

Before you start

  • Application already created (see: How to create an application)

Steps

  1. 1

    Open the application

    Go to your server, click "Applications", then click the application name to open its detail page.

  2. 2

    Change the primary domain

    In the "Domain" section, you can add aliases or change the primary domain. After saving, DeployFly updates the Nginx/Apache virtual host automatically. Make sure DNS points to your server before adding a domain.

  3. 3

    Switch PHP version

    In the "PHP" section, select a different PHP version from the dropdown. DeployFly updates the PHP-FPM pool for this application only — other applications are unaffected.

  4. 4

    Set the document root

    The document root is the folder Nginx/Apache serves publicly. For Laravel it should be `/public`, for WordPress it is the app root. Change it in the "Document Root" field and save.

  5. 5

    Manage environment variables

    The "Environment" section shows a key-value editor for environment variables injected into the PHP-FPM pool. These are available via `$_ENV` or `getenv()` in PHP. Use this instead of editing .env files manually.

  6. 6

    Configure Basic Auth

    Enable "Basic Auth" to password-protect the entire application with HTTP authentication. Useful for staging environments you don't want publicly accessible.

Watch out

  • Changing the document root on a live application will cause a brief 404 period while Nginx reloads. Do this during off-peak hours.

Tips

  • When adding a new domain alias, DNS propagation can take up to 48 hours. The alias will start working automatically once DNS resolves.
  • Environment variables set here take effect immediately — no service restart needed.

Related guides