Installation

Installing from the Marketplace

1. Log into your Jira Cloud instance as a Jira Administrator
2. Go to Settings (gear icon) → Apps → Find new apps
3. Search for ScriptForge
4. Click Install and confirm the permissions dialog

Alternatively, install directly from the Atlassian Marketplace by searching for ScriptForge and selecting your site.

Permissions Requested

During installation, Forge requests the following scopes:

Scope	Purpose
read:jira-work	Read issues, comments, attachments, worklogs
write:jira-work	Create/update issues, add comments, transition issues
manage:jira-configuration	Read project configurations, custom fields, workflows
storage:app	Persist configuration (listeners, jobs, rules) in Forge Storage
read:jira-user	Look up user profiles and groups

These are standard Forge app permissions. No data leaves the Atlassian cloud infrastructure.

Verifying Installation

After installation:

1. Navigate to Apps → ScriptForge in the top navigation bar
2. The ScriptForge admin panel should load showing the main dashboard
3. Try opening the Script Console — you should see the code editor

If the app does not appear in the Apps menu, ensure you have Jira Administrator permissions and try refreshing the page.

Updating

ScriptForge updates automatically through the Forge platform. When a new version is published:

• The app updates in the background with zero downtime
• Existing listeners, jobs, and configurations are preserved
• New features become available immediately after the update

Uninstalling

1. Go to Settings → Apps → Manage apps
2. Find ScriptForge in the list
3. Click Uninstall

Warning: Uninstalling removes all stored configurations (listeners, scheduled jobs, workflow rules, behaviours, scripted fields, and fragments). This action cannot be undone. Export your configurations first if you may reinstall later.