Skip to content

Installation

Like Docker? So do we!

One of the quickest ways to get pixelview running is using Docker. This page will show you the basics of how to use pixelview with Docker.

Host Requirements

Before proceeding with the installation, ensure that you have Docker and Docker Compose installed on your system. To do so you can follow the instructions provided on the docker's website.

Steps to Install

1. Copy Docker Compose File

Create a directory for your project and create a file named docker-compose.yml. Copy the provided service configurations into this file.

docker-compose.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
version: "3.9"

services:
  escalation:
    image: ghcr.io/pixelvirt/escalation:latest
    restart: always
    depends_on:
      - rabbitmq
    extra_hosts:
      - "mongoservice:172.17.0.1"
      - "rabbitmqservice:172.17.0.1"
    environment:
      MONGOURL: "mongoservice:27018"
      RABBITURL: "amqp://alertagility:vcW41MPUlM54uw@rabbitmqservice:5673/alertagility"

  finEscalation:
    image: ghcr.io/pixelvirt/findescalation:latest
    restart: always
    depends_on:
      - rabbitmq
    extra_hosts:
      - "mongoservice:172.17.0.1"
      - "rabbitmqservice:172.17.0.1"
    environment:
      MONGOURL: "mongoservice:27018"
      RABBITURL: "amqp://alertagility:vcW41MPUlM54uw@rabbitmqservice:5673/alertagility"

  alertagility:
    image: ghcr.io/pixelvirt/alertagility:latest
    restart: always
    ports:
      - "9090:9090"
    depends_on:
      - rabbitmq
    extra_hosts:
      - "mongoservice:172.17.0.1"
      - "rabbitmqservice:172.17.0.1"
    environment:
      MONGOURL: "mongoservice:27018"
      DOMAIN: "demo.pixelvirt.com"
      RABBITURL: "amqp://alertagility:wq:vcW41MPUlM54uw@rabbitmqservice:5673/alertagility"

  rabbitmq:
    image: ghcr.io/pixelvirt/inithive-rabbitmq:latest
    restart: always
    ports:
      - "5673:5672"
    environment:
      - RABBITMQ_PASSWORD=vcW41MPUlM54uw
      - RABBITMQ_USER=alertagility

  mongodb:
    image: mongo:5
    ports:
      - "27018:27017"
    volumes:
      - ./data:/data/db

  alert-frontend:
    image: ghcr.io/pixelvirt/alertagility-frontend:v2
    restart: always
    depends_on:
      - alertagility
    ports:
      - "80:80"
    environment:
      - BACKEND_URL=alertagility:9090

1.1 Clone Git Repository (Alternative to Manually Creating manifests Files)::

Clone the repository containing the Docker manifests:

git clone  https://github.com/pixelvirt/pixelview-docker.git
cd pixelview-docker/installation
💡 Note: Find DOMAIN and replace it with your actual domain name and adjust environments according to your system.

2. start the containers

Open a terminal window, navigate to the directory where the docker-compose.yml file is located, and run the following command:

docker compose up -d

This command will start all the services in detached mode, meaning they will run in the background.

3. Verify Installation

After running the docker-compose up -d command, you can verify that the services are running by executing:

docker compose ps

This command will display the status of all the services defined in the docker-compose.yml file.

4. Accessing the Application

Once the services are up and running, you can access the frontend application by opening a web browser and navigating to http://localhost.

5. Stopping Services

To stop the running services, execute the following command:

docker compose down

This will stop and remove all containers defined in the docker-compose.yml file.

Notes

  • The default username to access the frontend is admin@localhost

  • The default password is password

  • The services are configured to automatically restart (restart: always) in case of failures or system reboots.

  • The depends_on directive is used to define service dependencies, ensuring that dependent services are started before the dependent ones.

  • Ensure that your system meets the resource requirements for running the services, especially for memory and CPU.

  • You can customize environment variables and port mappings in the docker-compose.yml file as needed.

With these instructions, you should be able to successfully download and install the PixelView Services on your system. If you encounter any issues or have questions, refer to the Docker and Docker Compose documentation or feel free to ask for assistance.