A private Composer registry you can depend on.
Fast, self-hosted, and built for PHP teams who are tired of fragile workarounds.
Manage your packages with a registry that just works.

---

About Pricore

Managing private PHP packages should be simple. Pricore makes it that way. It provides a centralized, reliable way to store package metadata, control access with tokens, and integrate seamlessly with Git-based workflows.

With Pricore, teams gain full ownership of their package ecosystem while keeping dependency management fast, consistent, and transparent.

Why Pricore?

• Stay in control - Keep your private packages on your own infrastructure. No third-party servers, no external dependencies.
• Skip the manual work - Webhook-driven updates, a web dashboard, and full Composer v2 API support. Out of the box.
• Use what you know - Built on Laravel. If your team already knows the stack, you can run, extend, and contribute to Pricore from day one.

Features

• Private & Secure - Token-based auth, per-package access control. Your code stays yours.
• Git-Based Mirroring - Point Pricore at any Git repo. It mirrors, indexes, and serves automatically.
• Built on Laravel - Familiar stack, easy to extend. If you know Laravel, you know Pricore.
• Blazing Fast - Packages resolve in milliseconds. No waiting on external APIs.
• Web Dashboard - Browse packages, manage tokens, and view download stats from a clean UI.
• Webhook Support - Auto-update packages when you push. Works with GitHub, GitLab, and Bitbucket.
• Composer v2 Native - Full Composer v2 API support including metadata-url for lightning-fast resolves.
• Open Source - Apache 2.0 licensed. Run it, fork it, contribute to it. No vendor lock-in, ever.

Quick Start with Docker

60 seconds to a working registry. Three commands. That's all it takes.

1. Download the compose file

curl -o docker-compose.yml https://raw.githubusercontent.com/pricorephp/pricore/main/docker-compose.yml

2. Start the application

Migrations and setup run automatically on first boot.

docker compose up -d

3. Create your first user

Then open http://localhost:8000 and start adding packages.

docker compose exec app php artisan pricore:install

The entrypoint automatically generates an APP_KEY, creates the SQLite database, runs migrations, and caches configuration on first boot. For production, you can provide your own APP_KEY via environment variable.

Docker Services

Service	Description	Port
app	FrankenPHP web server	8000
horizon	Queue worker with Horizon dashboard	-
scheduler	Runs scheduled tasks	-
redis	Cache, sessions, and queues	-

Manual Installation

For development or custom deployments. Requires PHP 8.4+, Node.js 22+, Redis, and SQLite/MySQL/PostgreSQL.

# Clone the repository
git clone https://github.com/pricorephp/pricore.git
cd pricore

# Install dependencies
composer install
npm install

# Configure environment
cp .env.example .env
php artisan key:generate

# Run migrations
php artisan migrate

# Build frontend assets
npm run build

# Start the development server
composer run dev

Configuration

Environment Variables

Key configuration options in your .env file:

# Application
APP_NAME=Pricore
APP_ENV=production
APP_URL=https://packages.yourcompany.com

# Database (SQLite, MySQL, or PostgreSQL)
DB_CONNECTION=sqlite
DB_DATABASE=/path/to/database.sqlite

# Redis (required for queues)
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

# Queue & Cache
QUEUE_CONNECTION=redis
CACHE_STORE=redis
SESSION_DRIVER=redis

Using Pricore with Composer

1. Create an Access Token

1. Log in to your Pricore instance
2. Navigate to your organization settings
3. Create a new access token with the required scopes

2. Configure Composer

Add Pricore as a repository in your project's composer.json:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.yourcompany.com/org/your-organization"
        }
    ]
}

3. Authenticate

composer config --global --auth http-basic.packages.yourcompany.com token YOUR_ACCESS_TOKEN

4. Install Packages

composer require your-vendor/your-private-package

Development

Running the Development Server

# Start all services (server, queue, logs, vite)
composer run dev

# Or with SSR support
composer run dev:ssr

Code Quality

# Run tests
composer test

# Static analysis
composer run phpstan

# Format PHP code
composer run pint

# Format frontend code
npm run format

# Type-check TypeScript
npm run types

Project Structure

app/
├── Domains/           # Domain-driven design modules
│   └── Repository/    # Git repository syncing logic
├── Http/Controllers/  # HTTP controllers
├── Models/            # Eloquent models
└── Services/          # Application services

resources/
├── js/
│   ├── components/    # React components
│   ├── layouts/       # Page layouts
│   └── pages/         # Inertia pages
└── views/             # Blade templates (minimal)

Testing

# Run all tests
php artisan test

# Run specific test file
php artisan test tests/Feature/ExampleTest.php

# Run with coverage
php artisan test --coverage

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests and linting (composer test && composer run pint)
5. Commit your changes (git commit -m 'feat: add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Development Guidelines

• Follow PSR-12 coding standards (enforced by Pint)
• Write tests for new features
• Update documentation as needed
• Keep commits focused and atomic

Security

If you discover a security vulnerability, please send an email to pricore@maartenbode.com instead of using the issue tracker. All security vulnerabilities will be promptly addressed.

License

Pricore is open-source software licensed under the Apache License 2.0.

Acknowledgments

Pricore is built on the shoulders of giants:

• Laravel - The PHP framework
• Inertia.js - Modern monolith approach
• React - UI library
• Tailwind CSS - Utility-first CSS
• FrankenPHP - Modern PHP app server

---

Made with 💚 for the PHP community