# Agilicus Connector – QNAP

- Link: https://www.agilicus.com/anyx-guide/agilicus-connector-qnap/
- Published: 2025-02-01T20:38:29+00:00
- Author: Don Bowman

1. [Home](https://www.agilicus.com/)
 2. Agilicus Connector – QNAP

![qnap ts-133](https://www.agilicus.com/www/65aee495-image.png)

## Agilicus Connector – QNAP

Install the Agilicus connector on a QNAP NAS

[CONTACT](https://www.agilicus.com/contact-us/)

## QNAP Background

A QNAP NAS runs a custom Linux operating system, providing storage and other services
in a consumer and small to medium business environment.

Installing the Agilicus Connector on the NAS can facilitate accessing the shares
remotely, as well as providing a means of remote management.

## Install

The Agilicus Connector will run as a container on the QNAP. In order to do this,
you must have the Container Station feature enabled.

### Enable QNAP Container Station

![image](https://www.agilicus.com/www/e35785d7-image-1024x445.png)

![image](https://www.agilicus.com/www/71b93c83-image-1024x485.png)

![image](https://www.agilicus.com/www/7dd7fffd-image-1024x554.png)

### Create Agilicus Connector as Container

There are two methods to this: via the QNAP Web management interface, and, via the
QNAP shell. Both achieve the same objective. If you use the QNAP Web management 
interface, be aware there is an expiry time on the challenge-id when you are copying
from the Agilicus admin interface.

Option 1: QNAP Web interface

You will copy 3 fields from the Agilicus connector install screen (Resources/Connectors/
New): two environment variables, and one image. The image should be **cr.agilicus.
com/pub/images/agilicus-agent/client:stable** and the environment variables will
be AGILICUS_CHALLENGE_ID=XXX and AGILICUS_CHALLENGE_CODE=XXX. These latter two are
only good for a few minutes, regenerate if it takes you longer.

You will likely want to mount **your QNAP Volume(s)** into **the same location**(
via bind host mount path), allowing re-exporting shares via Agilicus Share. (e.g.
select ‘bind mount’ on the Storage screen, select the yellow file folder, pick a
shared directory, then copy the name to the next field).

Note: there is an error in the first mount image, it should not be /opt, it should
be /etc/agilicus/agent.

![Agilicus Connector for QNAP: Securely connect your QNAP NAS to AnyX for remote
access, file sharing, and enhanced security. Simplify your hybrid cloud storage 
solution with Agilicus.](https://www.agilicus.com/www/d96d213f-2025-03-31-qnap.gif)

![image](https://www.agilicus.com/www/52f900ed-image-1024x924.png)

![image](https://www.agilicus.com/www/bee4871c-image-1024x597.png)

![image](https://www.agilicus.com/www/1d8eaa5e-image-1024x598.png)

![image](https://www.agilicus.com/www/9aa40eb8-image-1024x599.png)

![image](https://www.agilicus.com/www/cdde9673-image-1024x597.png)

![image](https://www.agilicus.com/www/e1bbc461-image-1024x599.png)

![image](https://www.agilicus.com/www/9dc3e78e-image-1024x597.png)

![image](https://www.agilicus.com/www/4db25939-image-1024x597.png)

![image](https://www.agilicus.com/www/f1523945-image-1024x598.png)

![image](https://www.agilicus.com/www/598cfd71-image-1024x572.png)

Option 2: Paste via Shell

The command line given from the Agilicus Admin interface on the install new connector,
docker tab, will work as-is, you can just paste it. However, you will likelywant
to mount **/share** into **/share** (via bind host mount path), allowing re-exporting
shares via Agilicus Share. You can achieve this by adding -v /share:/share into 
the command line before the image. This will look like:

    ```wp-block-code
    docker run -d --name agilicus-connector --restart=always --net=host -v agilicus_cfg:/etc/agilicus/agent -e AGILICUS_CHALLENGE_ID=XXXXXXXX -e AGILICUS_CHALLENGE_CODE=XXXX -v /share:/share cr.agilicus.com/pub/images/agilicus-agent/client:stable
    ```

You can check the status or logs with

    ```wp-block-code
    docker logs -f agilicus-connector
    ```

You might consider setting the restart policy to always:

    ```wp-block-code
    docker update --restart=always  agilicus-connector
    ```

### QNAP Enable Shell Access

Below are two methods to enable a shell on the QNAP. Both will achieve the same 
objective.

Option 1: Enable SSH

Using the instructions at [https://www.qnap.com/en/how-to/faq/article/how-do-i-access-my-qnap-nas-using-ssh](https://www.qnap.com/en/how-to/faq/article/how-do-i-access-my-qnap-nas-using-ssh),
namely: “Control Panel/Network & File services / Telnet/SSH, Allow SSH connection”.

Option 2: Web Shell

Using the instructions at [https://www.myqnap.org/install-the-repo/](https://www.myqnap.org/install-the-repo/),

![image](https://www.agilicus.com/www/745642ef-image-1024x483.png)

From the MyQNAP menu on the left, select ‘search’, enter ‘gotty’, and install.

![image](https://www.agilicus.com/www/ddbae39c-image-1024x411.png)

You may now open a shell as:

![image](https://www.agilicus.com/www/711b4a2f-image-1024x666.png)

Once in the shell, login as your username/password