Skip to content

# Special Instructions for Installing with Docker on QNAP NAS (Intel/AMD)

These are preliminary instructions only!

User-supplied intelligence required! I'm not a QNAP user/owner but from what I was able to see in some searching and helping a user on the forums, the following is a generic guide to getting the container working on QNAP. I would appreciate screen shots and specific corrections (with detail, please).

1. Open Container Station;
2. Click Create Container;
3. In the search box, enter `reactor` and launch a search;
4. The QNAP-recommended list of results is probably going to be empty, but you should see a Docker Hub tab in the results area — click on that tab;
5. Scroll through the search results and find the `toggledbits/reactor` entry. Select the image for your system architecture (e.g. `toggledbits/reactor:latest-amd64` for an Intel/AMD-based NAS);
6. On the settings dialog that opens, leave all the defaults (Auto Start on, etc.);
7. Click the Advanced Settings link;
8. Click the Network nav item in the left navigation;
9. Set the network operating mode to Host;
10. Click the Environment nav item;
11. Leave all existing environment variables alone, but modify (or add) `TZ` and enter as its value the canonical name of your local timezone, which is of the form `area_name/locale_name` (e.g. `America/New_York` or `Europe/Prague`. If you don't know it, you can browse this list;
12. Click the Shared Folder nav item.
13. Create a directory somewhere on your NAS into which Reactor's configuration and data stores should be placed. This can be in your user home directory (recommended), or anywhere you normally have access to.
14. Add or modify a mount point `/var/reactor` to the full pathname of the directory you created in the previous step (put that in the Volume from host field for that row).
15. Start the container.

You should immediately observe that the directory you created for config and data is populated with some folders and files. You should then be able to access the UI by going to http://nas-ip-address:8111/

You may now proceed to Concepts & Terminology, where you'll learn some basics about Reactor's objects, and then start to configure your hubs/controllers and get access to their devices.

# Upgrading the Container

I need instructions from a knowledgeable QNAP user for this. On other systems, the typical way is to stop the container, pull the new image, clear the container (not delete it), then restart it. I don't know how it works on QNAP.

Updated 2023-Jan-16