dockware
  • dockware doc's
  • News
  • Setup
    • Docker Setup
    • What Image should you use?
    • Performance Tweaks
  • Use Dockware
    • First Run
    • Update Dockware
    • Advanced Run
    • Default Credentials
    • Symfony or Shopware 5
    • Changelog
  • Features
    • Intro
    • Environment Variables
    • Adminer
    • Mailcatcher
    • Switch PHP Version
    • Switch Node Version
    • Tideways Profiling
    • Pimp my Log
    • Filebeat
    • SSH Users
    • MySQL Users
    • Shopware Currency
  • Development
    • Intro
    • Start Developing
    • Switch Branches
    • Debugging
    • Watchers
    • App Development
    • Update Shopware
    • Dockware Essentials
    • Custom Domains
    • Custom Images
    • Code Coverage
    • CLI Build Shopware 6 Plugin
    • Multi-Environment Setups
  • Contribute
    • Intro
    • Setup Github Version
    • Create Feature
    • Code Styles
    • Testing
    • Create Pull Requests
  • CI/CD
    • Github
    • Gitlab
    • Bitbucket
    • Buddy
  • Tips & Tricks
    • Create a new Project
    • Bind-Mounting
    • Persisting Data
    • Housekeeping
    • Online Servers
    • Performance on Mac
    • Security
  • FAQ
    • Sequel Pro
    • Dockware and other images
    • Scripts (PSH?)
    • Redis
    • Error Port not available
    • MySQL failed
    • Elasticsearch
    • Windows Problems
    • Chrome Problems
    • Import MySQL Dump
    • Shopware 5 Support
    • Use Https/SSL
    • Container hangs in Pipeline
    • Disable the admin worker
  • Additional Links
    • Imprint
    • Founders
    • Dockware website
    • Dockware in Shopware Slack
Powered by GitBook
On this page

Was this helpful?

  1. Development

Custom Domains

PreviousDockware EssentialsNextCustom Images

Last updated 2 years ago

Was this helpful?

We have prepared everything for a smooth launch using But it's of course possible to use your custom domain.

There are only 3 things to configure:

  1. Change Shopware Domain Configure your custom domain either in the Shopware administration (Sales Channel) or directly in your database. Make sure to enter the correct HTTP protocol along with your custom domain, such as "".... You can also use a custom port in here by appending it to your domain like in this example "". (please note that this port needs to be exposed in Docker!)

  2. Clear Caches Make sure to clear the caches of your Shopware shop. Otherwise, you will get an error in the storefront.

  3. Edit your .env Make sure you enter the new domain in your .env in APP_URL to ensure also extensions installations will work propper with licenses.

  4. Configure Domain on Host We need to tell your host that requests to this new domain are being forward to your localhost. This can be by modifying the local /etc/hosts file. Just open it and add your new domain along with the localhost IP address like here:

/etc/hosts
127.0.0.1        dockware-local.com

Congratulations! Your Shopware shop is now accessible under your custom domain!

Proxies, Load Balancers and Ports

If you use any kind of proxy before the container, or if you use a custom port, please note that you might need to adjust a few things here.

So your proxies obviously need to listen to that domain too and forward it to the Shopware container.

Also, if you use a custom port, please make sure that this port is also accessible by exposing it within your Docker infrastructure like in this example

image: dockware/play:latest
ports:
    - "80:80"
    - "1000:1000" # new 1000 port that is used in sales channel

If you change the port, you have to edit your saleschannel domains in the database, otherwise shopware will not find a matching saleschannel.

For the example above you would have to do something like:

http://my.fancy-shop.com:1000

http://localhost!
http://dockware-local.com
http://localhost:1000