Multiple deployments on one server

Bitcart supports multiple deployments on one server.

Note that it is an advanced topic, and use it only if you know what you are doing.

When setting up multiple deployments on the same server, the services that export their ports to outside can't be run twice.

It means that you will need to set up nginx reverse proxy manually, and disable nginx in each of the deployments.

When disabling nginx, all the services will expose ports to outside, to be able to use them from nginx installed globally on the server.

To run multiple deployments, pass the deployment name via --name argument. The default deployment name is compose.

./ --name demo
./ --name test
./ --name production

Note that you should use different clones of the bitcart-docker for each deployment, as the setup script creates .env file with all your settings, and .deploy file with configuration name, and if you run different deployments in the same directory the configuration files will be overwritten.

Do it like so:

git clone
cd bitcart-docker
# export settings
cd ..
git clone bitcart-demo
cd bitcart-demo
# export settings
./ --name demo
cd ..
# do the same process for each deployment

To disable reverse proxy, run:


Note that when running multiple deployments, the Merchants API, the admin and the store will have the same ports. You need to change that.

To change ports, run export BITCART_SERVICE_PORT=port

Where SERVICE is the component name, and port is the port, for example:

export BITCART_BACKEND_PORT=8001 # set merchants API port to 8001
export BITCART_ADMIN_PORT=4001 # admin panel at port 4001
export BITCART_STORE_PORT=3001 # store at port 3001

You should configure nginx yourself. The only recommendation is: it is easy to configure nginx via certbot.

Instead of disabling nginx, you may also leave it running at different ports, see this guide.


sudo certbot --nginx -d your.domain.tld

And it will create nginx config records for you, and then edit the location / config, by using proxy_pass http://localhost:port

Note: when using multiple deployments on one server, environment variables may be loaded incorrectly on login (due to same environment variable names).

To ensure that you have loaded the correct environment for your deployment, in your deployment directory, run:


It will load the correct settings.

Last updated