This page describes how to install our InterActor Community Edition. Although we've done our best to provide a good instruction to get you started, there may always be things we have not covered and which need additional explanation. The best place to look for answers to your questions is our InterActor-users team on Slack. Feel free to send a message to firstname.lastname@example.org so we can send you an invite.
The use of InterActor Community Edition is subject to the InterActor Community Edition End User License Agreement.
Download InterActor Docker image
InterActor can be downloaded as a Docker image. This requires Docker to run. If you do not have Docker installed, please follow the instuctions on the Docker website to install it.
You can download and install InterActor in two ways: direct download or from the Docker Hub.
You can get the latest InterActor Docker image by clicking the link below:
Then, in your terminal, navigate to your download directory and type
docker load < interactor-community-image-latest.tar.gz
You can also get the latest version from Docker Hub, by typing
docker pull graphileon/interactor-community
Run InterActor image
You can run the InterActor image using the following command, which will also create a volume "interactor" where persistent data (the config, and files you upload to InterActor) will be stored.
$ docker run -t -d -p 8000:80 --name interactor -v interactor:/persistent/ graphileon/interactor-community 778a9a7f373fc040e1adb3af446d7f2bfab9d82d15d82e5871c9658b54036a78
Now Docker should return InterActor in its list of running images.
$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 778a9a7f373f graphileon/interactor-community "/bin/sh -c 'HOST=$(n" 16 seconds ago Up 15 seconds 443/tcp, 0.0.0.0:8000->80/tcp interactor
To restart the InterActor docker container, run the command:
$ docker restart interactor
The url that InterActor can be accessed at consists of an address and a port. If you used the
docker run command from this documentation, the port is 8000. Depending on your Docker installation, this IP address can be different.
- Docker Native: http://localhost:8000
- Docker Toolbox: Docker Toolbox has its own IP address, which you can find from your Docker Terminal using the command
$ docker-machine ip default
For example, if the above command outputs 192.168.99.100, the address that you will find InterActor is http://192.168.99.100:8000.
When you run InterActor for the first time, you'll be redirected to the InterActor Settings page, where you'll be prompted to enter user credentials that you want to use to access InterActor, as well as the connection settings of your Neo4j instance.
If you have your Neo4j instance ready, you can provide its information in the application store settings. Note that if you're running Neo4j on your local machine, the IP address you should provide for the Neo4j store may be different than usual (see Using a local Neo4j instance below).
With the Enterprise Edition, you can store InterActor Functions in a separate graph store from your data. This feature is not available in the Community Edition.
After clicking "Apply Settings", InterActor will do a one-time installation,
creating nodes and relationships in your Neo4j instance. These nodes will
have labels starting with
IA_, which allows you to recognize them easily.
Confirm all settings and click 'Apply Settings' to start the installation.
If everything went well, you should see the login dialog. You can now log in with the username and password you provided in the settings.
InterActor sends a single anonymized 'call home' message to Graphileon for statistics.
Using a local Neo4j instance
In order to use InterActor with a local Neo4j instance, you will need to configure Neo4j and find the IP address that, within the Docker container, refers to your local machine.
Local machine IP address
If your Neo4j instance runs on the same machine as your Docker instance, the ip address you need enter as Neo4j host may differ from machine to machine. Below are the default IP addresses for the most common operation systems and Docker versions:
|Configuration||IP Address||How to find it|
|Linux/MacOS & Docker Native||172.17.0.2||Run
|Windows & Docker Native||10.0.75.1||In PowerShell (or Command Prompt), run
|MacOS & Docker Toolbox||10.0.2.2||This is the IP address VirtualBox uses to address the host machine from a virtual machine.|
By default, Neo4j only listens to localhost. Although InterActor also runs on your machine, it runs within a Docker container, which is considered, for all intents and purposes, a separate machine. So you will need to tell Neo4j to allow connections from outside localhost.
To do this, change this line in neo4j.conf:
After saving the neo4j.conf file, you need to restart Neo4j.
Firewalls et cetera have to be configured accordingly as well. For Windows 10: check whether the Firewall is configured correctly, go to Control Panel > System and Security > Windows Firewall > Allowed Apps and look for "neo4j-ce".
If you're on a public network, make sure the "Public" column is checked. On a private network, make sure the "Private" column is checked.