Magento: storing base url in a config file

Magento: storing base url in a config file

September 4, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento: storing base url in a config file

Storing Magento Base URL in Config Files: A Developer’s Guide

In modern e-commerce development, it’s crucial to maintain consistency across different environments such as local development, staging, and production. One of the most fundamental settings that needs to remain consistent is the base URL of your Magento store.

The Challenge: Base URL in the Database

By default, Magento stores the base URL (web/secure/base_url) in the core_config_data table of your database. While this works well for a single environment, it poses challenges when you need to:

  1. Switch between development and production versions.
  2. Export settings from one environment to another.

The Solution: Config Files to the Rescue

To overcome these challenges, we can use Magento’s config files (app/etc/config.php) to store the base URL instead of the database. This approach offers several benefits:

  • Consistency: You can maintain a single configuration file across all your environments.
  • Ease of export/import: It becomes trivial to export and import settings between environments.
  • Version control: You can version config files, ensuring traceability.

How to Store Base URL in Config Files

Step 1: Create or Open the Config File

The config.php file is located at app/etc/config.php. If it doesn’t exist, you can create an empty one. Be sure to have a backup before making changes.

Step 2: Add the Base URL Configuration

You need to add an array with the key web/secure/base_url under the config array in the file. Here’s how:

"web" => [
    "secure_base_url" => "https://your-production-url.com/"
],

Replace "https://your-production-url.com/" with your actual base URL.

Step 3: Update Your Magento Installation

After adding or updating the config.php file, you need to update your Magento installation. You can do this by running:

php bin/magento setup:upgrade

This command will apply the changes from the configuration files.

Best Practices and Tips

  1. Version Control: Always keep your config files under version control (like Git). This ensures you have a history of changes and can revert if needed.
  2. Environment-specific Files: For larger projects, consider using environment-specific config files (e.g., config.development.php, config.production.php) and include them in the main config.php file.

Conclusion

Storing the base URL in Magento’s config file provides a powerful way to manage your store settings across different environments. It offers better control, consistency, and ease of export/import compared to the traditional database approach.

At Laravel Company, we’ve covered this topic in more detail, including how to handle other configuration settings like currency codes and time zones. I recommend checking out that post for a comprehensive guide on Magento configuration best practices.

Remember, while this method is powerful, it’s important to follow secure coding practices when handling sensitive data in config files. Always ensure your files are protected from unauthorized access.

Happy configuring!

Catalog Database Configuration Import/Export

Our network