Access on the local network

Sometimes you need to run your CMA application in a mode where other users can access it to look at the development progress.

1. Get an IP address

Every device that is connected to the local is assigned an IP address in that network. Usually, this is done by the router. To get your IP address on the local network, use the following guide:

Ubuntu

ifconfig -a

Manjaro Linux

ip -4 addr | grep 192.168

macOS

ipconfig getifaddr en0
> 192.168.0.xxx

2. Make port public

Each OS has a different approach to opening ports in its firewall.

Linux

We will be using UFW to control iptables rules.

Ubuntu

# install it
sudo apt-get install ufw

# enable service
sudo ufw enable

# make sure that it is running
sudo ufw status verbose

# open port
sudo ufw allow in 80/tcp

# now we have port 80 available outside of our system

Manjaro Linux

# install it
pamac install ufw

# enable service
sudo systemctl enable ufw.service
sudo ufw enable

# open port
sudo ufw allow in 80/tcp

# now we have port 80 available outside of our system

MacOS

Go to System Preferences > Security & Privacy > Firewall. Enable firewall. Then go to Firewall Options and make sure the only two options selected are Automatically allow built-in software to receive incoming connections and Automatically allow downloaded signed software to receive incoming connections.

3. Setup CMA

magento-scripts 2.2.x and newer

Add to your cma.js file field host with your IP address:

module.export = {
    ... // other configuration
    storeDomains: {
        admin: '192.168.0.100'
    }
}

That is it! Now your devices on the local network can communicate with your CMA instance!

You also need to apply changes by running the start command without -s option.

Learn more about storeDomains here!

magento-scripts 2.1.x and older

Add to your cma.js file field host with your IP address:

module.export = {
    ... // other configuration
    host: '192.168.0.100'
}

That is it! Now your devices on the local network can communicate with your CMA instance!

You also need to apply changes by running the start command without -s option.