Run ElectricFlow Community Edition in a Docker container and get your server up and running in minutes. The Community Edition container runs all components of the ElectricFlow architecture in one container, making it simple to get started.
Follow the steps below to pull and start the ElectricFlow Docker appliance.
Prerequisite: Install Docker
Before getting started, first make sure you have Docker installed on your system. Visit https://www.docker.com/ and follow the instructions to install Docker on your platform.
Step 1: Run the ElectricFlow container appliance with Docker
If running using Docker Toolbox on Windows, see the end of the document for additional instructions for starting and accessing the container.
Run the following docker command to download and start the ElectricFlow container:
$ docker run --name efserver --hostname=efserver -d -m 4g --memory-swap 4g -p 8080:8080 -p 9990:9990 -p 7800:7800 -p 7070:80 -p 443:443 -p 8443:8443 -p 8200:8200 -i -t ecdocker/eflow-ce
This will pull the ElectricFlow container image from Electric Cloud’s Docker Hub registry, and then start the container named ‘efserver’ in detached mode with the appropriate port mappings.
NOTE: The container should be allocated minimum of 4 GB RAM and 2 CPUs to support the ElectricFlow server.If this is the first time you are running this command, it will take a few minutes to first pull and extract the Docker container image.
Step 2: Create your admin account
Wait for the container to start completely, this may take a few minutes. Once the container is up, open a browser and go to http://localhost:7070/register to create your admin account for the appliance.
Enter your email address and password that will be used as your admin account to login to the appliance and click Next
The ElectricFlow UI should open automatically after you register.
If it doesn’t, go to http://localhost:7070/flow to get started with ElectricFlow
Step 3: Get Started in Electric Flow
Visit http://localhost:7070/flow to open the ElectricFlow UI and login with the admin account details you entered in step 2.
Get started quickly by completing the in product tutorials that give you step by step guidance through creating your first application and pipeline:
Visit learn.electric-cloud.com/flow/start to learn more.
Connect to the Container
If you need to connect to the container, the credentials are:
You can execute commands on the container using docker exec, and the ecloud user:
$ docker exec -it --user ecloud efserver /bin/bash
Running on Docker Toolbox for Windows
Docker Toolbox for Windows will create a VM with 1 GB RAM and 1 CPU be default. The ElectricFlow server requires a minimum of 2 GB RAM and 2 CPUs. Before issuing the “docker run” command, increase the size of your VM by:
- Stopping the VM
$ docker-machine stop default
- Increase the default values to 2 GB RAM and 2 CPUs
- Start the VM
$ docker-machine start default
- Run docker run to start the container as show in in Step 1
To create your account and access ElectricFlow, you must connect to the VM running the container instead of localhost. Run the command below to and get the IP Address from the DOCKER_HOST field:
$ docker-machine env
Replace <CONTAINER_IP> with your IP address, and open:
To Access ElectricFlow: http://<CONTAINER_IP>:7070/flow