# Installing an additional instance of Replicate

The installation directory of an instance depends on the user running the script.

* If the script is run as root, the instance will be installed as a service
* If the script is run by a non-root user, the installation directory of the instance will be the Replicate bin directory

Information noteInstalling an instance will not start the instance.

Syntax:

[pass=server\_password] data=data\_directory iport=internal\_port\_number rport=rest\_port\_number arep.sh install instancename

Example:

pass=Abcdefghijklmnop12345 data=/opt/mydata iport=5342 rport=5341arep.sh install myreplicateinstance

Command parameters

| Parameter | Description |
| --- | --- |
| [pass=password] | Sets the server password.<br><br>Users will be prompted for this password when connecting to the Replicate server through the Replicate Web Console.<br><br>You can either set this password when installing Replicate (recommended) or you can set it later as described in [Changing the server password](https://help.qlik.com/en-US/replicate/May2026/Content/Replicate/Main/Security/Change_Server_Password.htm). |
| data=replicate\_data\_directory | Use this parameter to install the Replicate data directory to a non-default location.<br><br>Example:<br><br>data=/opt/mydata |
| iport | The internal port, which must be a decimal number greater than 1023 but less than 65535. |
| rport | The REST port, which must be a decimal number greater than 1023 but less than 65535. |
| instancename | The name of the service to create. |

Running the script will:

* Confirm not using instance name / port numbers / data directory that are already in use

  Information noteReinstalling an instance after it was just stopped and uninstalled may require a few minutes wait until tcp releases the port(s)

* Determine the data directory and port numbers, using the command line parameters or default values

* Create a configured copy of itself, named instance, installed in the instance installation directory

* Add an instancename record to a list of installed instances in services\_list.txt

* Create a functionally empty instance specific file in the data directory named instancename\_arep\_login.sh for instance specific settings

* If a server password is specified, the script will run repctl to set the admin UI server password