# Pagure

Pagure is a light-weight git-centered forge based on pygit2.

Features:

- `Open-sources`: Web-interface for the git repositories

- `Flexibility`: Ability to create any project you want

- `One place`: Keep your documentation and tickets in pagure

- `Collaboration`: Fork a project and make a pull-request

- `Integration`: Create pull-request from a fork hosted somewhere else than in pagure

- `Open data`: Sources, doc, ticket and pull-requests meta-data are available in the web interface but also in git repos which can thus be cloned and changed locally.

- `Freedom`: Pagure is fully Free and Open-Source Software!

Resources:

- Home page

- Git repository

- Github mirror

Contents:

- Overview
  - Pagure core application
  - Pagure workers
  - Gitolite
  - Pagure doc server
  - Pagure milter
  - Pagure EventSource Server
  - Pagure web-hook Server
  - Pagure load JSON service
  - Pagure log com service
- Usage
  - First Steps on pagure
  - Forks
  - Understanding Read Only Mode of projects
  - HTTP PUSH
  - Pull Requests
  - Using Markdown in Pagure
  - Project settings
  - Project Level Access Control
  - Using the roadmap feature
  - Flags
  - Magic Words
  - Using the doc repository of your project
  - Using web-hooks
  - Templates for ticket input
  - Customize the PR page
  - Theming Guide
  - Upgrade a database
  - Pagure CI
  - Quick replies
  - Troubleshooting
  - Tips and tricks
  - Pagure API
- Installing pagure
  - Installing pagure via RPM
  - Installing pagure via setup.py
  - Set-up pagure
  - Set up virus scanning
- Installing pagure’s milter
  - Configure your system
- Installing pagure’s EventSource server
  - Configure your system
- Installing pagure’s web-hooks notification system
  - Configure your system
- Installing pagure-ci
  - Configure your system
- Installing pagure-loadjson
  - Configure your system
- Installing pagure-logcom
  - Configure your system
- Cron Jobs
  - API key expiration reminder
- Configuration
  - Must options
  - Repo Directories
  - Configure Pagure Auth
  - Configure Gitolite
  - EventSource options
  - Web-hooks notifications
  - Redis options
  - Authentication options
  - Celery Queue options
  - Stomp Options
  - API token ACLs
  - Optional options
  - RepoSpanner Options
  - MQTT Options
  - Deprecated configuration keys
- Plugins
  - Loading the configuration
  - The configuration file
- Customize the gitolite configuration
- Development
  - Get the sources
  - Dependencies
  - How to run pagure
  - Run pagure for development
  - Create a pull-request for testing
  - Coding standards
  - Send patch
  - Unit-tests
- Contributing
- Contributors to pagure
- Runs Here
  - List of locations where Pagure is currently used

- Changelog

This documentation is generated from the `doc` folder in the pagure’s sources. Feel free to report issues about the documentation on the pagure issue tracker or even better, contribute to it!

# Indices and tables

- Index

- Module Index

- Search Page