Proxy server settings

The protection agents can transfer data through an HTTP/HTTPS proxy server. The server must work through an HTTP tunnel without scanning or interfering with the HTTP traffic. Man-in-the-middle proxies are not supported.

Because the agent registers itself in the cloud during the installation, the proxy server settings must be provided during the installation or in advance.

In Windows

If a proxy server is configured in Windows (Control panel > Internet Options > Connections), the setup program reads the proxy server settings from the registry and uses them automatically. Also, you can enter the proxy settings during the installation, or specify them in advance by using the procedure described below. To change the proxy settings after the installation, use the same procedure.

To specify the proxy settings in Windows

Create a new text document and open it in a text editor, such as Notepad.

Copy and paste the following lines into the file:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Acronis\Global\HttpProxy]
"Enabled"=dword:00000001
"Host"="proxy.company.com"
"Port"=dword:000001bb
"Login"="proxy_login"
"Password"="proxy_password"

Replace proxy.company.com with your proxy server host name/IP address, and 000001bb with the hexadecimal value of the port number. For example, 000001bb is port 443.
If your proxy server requires authentication, replace proxy_login and proxy_password with the proxy server credentials. Otherwise, delete these lines from the file.
Save the document as proxy.reg.
Run the file as an administrator.
Confirm that you want to edit the Windows registry.
If the protection agent is not installed yet, you can install it now.
Open file %programdata%\Acronis\Agent\etc\aakore.yaml in a text editor.

Locate the env section or create it and add the following lines:

env:
    http-proxy: proxy_login:proxy_password@proxy_address:port
    https-proxy: proxy_login:proxy_password@proxy_address:port

Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.
In the Start menu, click Run, type: cmd, and click OK.
Restart the aakore service by using the following commands:
```
net stop aakore
net start aakore
```
Restart the agent by using the following commands:
```
net stop mms
net start mms
```

In Linux

Run the installation file with the parameters --http-proxy-host=ADDRESS --http-proxy-port=PORT --http-proxy-login=LOGIN--http-proxy-password=PASSWORD. To change the proxy settings after the installation, use the procedure described below.

To change the proxy settings in Linux

Open the file /etc/Acronis/Global.config in a text editor.

Do one of the following:

If the proxy settings were specified during the agent installation, find the following section:

<key name="HttpProxy">
    <value name="Enabled" type="Tdword">"1"</value>
    <value name="Host" type="TString">"ADDRESS"</value>
    <value name="Port" type="Tdword">"PORT"</value>
    <value name="Login" type="TString">"LOGIN"</value>
    <value name="Password" type="TString">"PASSWORD"</value>
</key>

Otherwise, copy the above lines and paste them into the file between the <registry name="Global">...</registry> tags.

Replace ADDRESS with the new proxy server host name/IP address, and PORT with the decimal value of the port number.
If your proxy server requires authentication, replace LOGIN and PASSWORD with the proxy server credentials. Otherwise, delete these lines from the file.
Save the file.
Open file /opt/acronis/etc/aakore.yaml in a text editor.

Locate the env section or create it and add the following lines:

env:
    http-proxy: proxy_login:proxy_password@proxy_address:port
    https-proxy: proxy_login:proxy_password@proxy_address:port

Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.
Restart the aakore service by using the following command:
```
sudo service aakore restart
```
Restart the agent by executing the following command in any directory:
```
sudo service acronis_mms restart
```

In macOS

You can enter the proxy settings during the installation, or specify them in advance by using the procedure described below. To change the proxy settings after the installation, use the same procedure.

To specify the proxy settings in macOS

Create the file /Library/Application Support/Acronis/Registry/Global.config and open it in a text editor, such as Text Edit.

Copy and paste the following lines into the file

<?xml version="1.0" ?>
<registry name="Global">
    <key name="HttpProxy">
        <value name="Enabled" type="Tdword">"1"</value>
        <value name="Host" type="TString">"proxy.company.com"</value>
        <value name="Port" type="Tdword">"443"</value>
        <value name="Login" type="TString">"proxy_login"</value>
        <value name="Password" type="TString">"proxy_password"</value>
    </key>
</registry>

Replace proxy.company.com with your proxy server host name/IP address, and 443 with the decimal value of the port number.
If your proxy server requires authentication, replace proxy_login and proxy_password with the proxy server credentials. Otherwise, delete these lines from the file.
Save the file.
If the protection agent is not installed yet, you can install it now.
Open file /Library/Application Support/Acronis/Agent/etc/aakore.yaml in a text editor.

Locate the env section or create it and add the following lines:

env:
    http-proxy: proxy_login:proxy_password@proxy_address:port
    https-proxy: proxy_login:proxy_password@proxy_address:port

Replace proxy_login and proxy_password with the proxy server credentials, and proxy_address:port with the address and port number of the proxy server.
Go to Applications > Utilities > Terminal
Restart the aakore service by using the following commands:
```
sudo launchctl stop aakore
sudo launchctl start aakore
```

Restart the agent by using the following commands:

sudo launchctl stop acronis_mms
sudo launchctl start acronis_mms

In bootable media

When working under bootable media, you may need to access the cloud storage via a proxy server. To specify the proxy server settings, click Tools > Proxy server, and then specify the proxy server host name/IP address, port, and credentials.