# Deploy Ploi Roadmap with Easypanel

URL: /templates/ploi-roadmap

Roadmap is an open-source software designed to streamline your roadmapping process. It offers a completely customizable platform where you can mention users in comments, upvote items to prioritize them, and generate automatic slugs. The software also features a Filament admin panel and a simplified role system that includes administrator, employee, and user roles. Roadmap supports OAuth 2 single sign-on with your own application and automatically generates OG images, including the branding color you've set up. It also integrates with GitHub, allowing you to assign a repository to each project and manage issues directly from the roadmap admin. The software is built with PHP and requires a database to function.

## Installation notes

After First Deployment, run "php artisan roadmap:install" to setup the inital user account.

## Benefits

### Customisable Roadmapping

Roadmap is an open-source software designed to cater to your roadmapping needs. It allows you to create a completely customisable roadmap, enabling you to plan and strategise effectively.

### Prioritise Tasks

With the ability to upvote items, you can easily identify which tasks or projects have more priority. This feature helps in better decision-making and resource allocation.

### Easy User Management

Roadmap comes with a simplified role system, including roles such as administrator, employee, and user. This makes it easy to manage users and their access levels within the application.

### Single Sign-On

Roadmap supports OAuth 2 single sign-on with your own application, providing a seamless and secure login experience for users.

### Automatic Image Generation

The software automatically generates Open Graph (OG) images, including the branding color you've set up. This feature helps in enhancing the visual appeal and recognition of your roadmap.

## Features

### Customisable Roadmapping

Create a completely customisable roadmap to plan and strategise effectively.

### User Mentions

Mention users in comments to facilitate communication and collaboration.

### Upvote System

Upvote items to identify which tasks or projects have more priority.

### Automatic Slug Generation

Automatically generate slugs for your items, making them easier to reference and find.

### Admin Panel

Manage your roadmap and users with the easy-to-use Filament admin panel.

### Role System

Manage users and their access levels with the simplified role system.

### Single Sign-On

Provide a seamless and secure login experience with OAuth 2 single sign-on.

### Automatic Image Generation

Enhance the visual appeal of your roadmap with automatically generated OG images.

## Configuration

- `appServiceName` (App Service Name, required): ploi-roadmap

- `appServiceImage` (App Service Image, required): ghcr.io/easypanel-community/docker-ploi-roadmap:1.44.0

- `databaseServiceName` (Database Service Name, required): ploi-roadmap-db

- `adminNotifications` (Admin Notifications, required): true

- `appLanguage` (Language, required): en

- `appTimezone` (Timezone, required): utc

## Services

- ploi-roadmap: app (ghcr.io/easypanel-community/docker-ploi-roadmap:1.44.0)

- ploi-roadmap-db: mariadb

## Resources

- [Github](https://github.com/ploi-deploy/roadmap)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/ploi-roadmap)