Step by step guide to install Apache AGE Viewer
Tags: apacheage, postgres, database, agedb
Published: 2023-04-25 22:22:25

In this post, we will discuss how to install AGE viewer from source code on windows machine.

**Prerequisites**
Before proceeding with the installation of AGE viewer from source code on your Windows machine, make sure you have the following prerequisites in place:

1. PostgreSQL: You should have PostgreSQL version 11 or 12 already installed on your machine. If you haven't installed it yet, you can follow this guide for step-by-step instructions: [Step by Step Guide to Install PostgreSQL on Windows](https://dev.to/omarsaad/step-by-step-guide-to-install-postgresql-apache-age-on-windows-28gf).

2. Apache AGE: Apache AGE should be installed and configured with PostgreSQL on your PC. If you haven't installed and configured Apache AGE yet, you can refer to the same guide mentioned above: [Step by Step Guide to Install PostgreSQL + Apache AGE on Windows](https://dev.to/omarsaad/step-by-step-guide-to-install-postgresql-apache-age-on-windows-28gf).

3. Git: You should have Git installed on your machine. If you don't have it installed, you can download and install it from the official Git website [Git Installation](https://git-scm.com/).

4.Node.js: You should have Node.js installed on your machine. Node.js is a JavaScript runtime that AGE viewer relies on. You can download and install Node.js from the official Node.js website [Node.js Installation](https://nodejs.org/).

By ensuring that you have PostgreSQL, Apache AGE, Git, and Node.js installed and configured correctly, you'll be ready to proceed with the installation of AGE viewer from source code on your Windows machine.

**What is Apache AGE ?**

Apache AGE is a graph database system that is built on top of PostgreSQL. It allows users to store, manage, and analyze large-scale graph data in a highly performant and scalable way.

Apache AGE combines the benefits of a powerful relational database management system (PostgreSQL) with the flexibility and scalability of a graph database. This means that users can store their data in a relational format and also perform graph-based queries and analyses on the data.

**What is Apache-Age Viewer**

Apache-Age Viewer is a web based user interface that provides visualization of graph data stored in a PostgreSQL database with AGE extension. It is graph visualization tool, for Apache AGE [1].

**How to install Apache AGE viewer ?**

1. Choose a directory where you want to install the project, and then open the Command Prompt (CMD) terminal in that directory.

2. Clone the age-viewer project by running the following command in the terminal:

```
git clone https://github.com/apache/age-viewer.git
```
3. navigate to the project directory.

```
cd age-viewer
```

4. Install the required node modules using.

```
npm run setup
```
5. Now you can start the `age-vewer` project.

```
npm run start
```

6. After completing the installation and running the Apache AGE viewer application, your web browser will automatically open with the URL `localhost:3000`.

7. Next, you need to establish a connection to a database by filling out the required information, as shown in the image below:

![AGE Viewer DB connection](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/95myrwylrstha25xklm9.png)

Please ensure that you provide all the necessary details correctly, including the database host, port, username, password, and database name. Once you have entered the information, you can proceed to establish the connection to the database, which will enable the Apache AGE viewer application to access and retrieve data for analysis and visualization.

Congratulations! With Apache AGE viewer successfully installed, you can now run queries and visualize graph data to gain insights from your database. We hope you found this tutorial helpful and enjoyable. If you have any further questions or need additional assistance, feel free to ask. Thank you for following this installation guide!

**References**
[age-viewer](https://github.com/apache/age-viewer)
[Step by step guide to install PostgreSQL + Apache AGE on Windows](https://dev.to/omarsaad/step-by-step-guide-to-install-postgresql-apache-age-on-windows-28gf)