PHPackages philip/laravel-instagres - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. philip/laravel-instagres ActiveLibrary[Database & ORM](/categories/database) philip/laravel-instagres ======================== Laravel integration for Neon Claimable Postgres — instant PostgreSQL databases, no signup v0.3.0(2mo ago)08MITPHPPHP ^8.2|^8.3|^8.4CI passing Since Nov 13Pushed 2mo agoCompare [ Source](https://github.com/philip/laravel-instagres)[ Packagist](https://packagist.org/packages/philip/laravel-instagres)[ Docs](https://github.com/philip/laravel-instagres)[ RSS](/packages/philip-laravel-instagres/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (22)Versions (12)Used By (0) Instagres for Laravel ===================== [](#instagres-for-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/d52e362b7601b22784b7f14651522327aa153a6c72242687506d65c4cf16e18a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69702f6c61726176656c2d696e737461677265732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/philip/laravel-instagres)[![Total Downloads](https://camo.githubusercontent.com/4df5ec90403dca87d11bc5d1e5104e3e9b824044a352587208b6f750656318ae/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7068696c69702f6c61726176656c2d696e737461677265732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/philip/laravel-instagres) This package connects Laravel to [Neon Claimable Postgres](https://neon.com/docs/reference/claimable-postgres). You can create a database and keep using it with the returned connection URLs without a Neon account or API auth. Sign in to Neon only when you claim a database into your account. The package builds on [`philip/instagres`](https://github.com/philip/instagres-php). Features -------- [](#features) - Instant provisioning. **No Neon account or auth** to call the create API from Artisan or the facade - Connect with the returned URLs. **No Neon login** for queries (only for **claim**) - Immediate connection string availability. Artisan can write **`DB_*`**, **`DB_URL`**, or named keys to **`.env`** - **72-hour** lifespan unless you **claim** the database for permanent use in Neon (`claim_url` in the response) - Create a database with **`php artisan instagres:create`** or **`Instagres::create()`** - Pooled and direct connection strings in the API response (`--direct-url` puts the direct string on the default connection when you use **`--set-default`**) - **instagres-php** handles HTTP and helpers: create, **`Client::getDatabase($id)`** (same response shape as create), connection parsing, claim URLs, and UUID generation - Optional logical replication on create (command flag or config) - Laravel 10.x through 13.x, PHP `^8.2` Installation ------------ [](#installation) ``` composer require philip/laravel-instagres ``` Laravel loads the package through [package discovery](https://laravel.com/docs/packages#package-discovery). Publish the config when you want to tune API ref, referrer, logical replication, or the default claim URL variable name: ``` php artisan vendor:publish --tag="instagres-config" ``` Quick start ----------- [](#quick-start) **Set the default database** (writes pooled `DB_*` keys to `.env`): ``` php artisan instagres:create --set-default ``` Pooled connections fit typical web and API traffic. Add **`--url`** when you want one **`DB_URL`** line instead of separate **`DB_*`** keys. **Run in CI or scripts** without prompts: ``` php artisan instagres:create --set-default --force ``` **Use a direct (non-pooled) endpoint** on the default connection when migrations or tooling require it: ``` php artisan instagres:create --set-default --direct-url --force ``` **Save a second database** without changing the default connection: ``` php artisan instagres:create --save-as=staging ``` **Print claim URLs** so you can keep a database past the trial window: ``` php artisan instagres:claim-url ``` If you skip **`--set-default`** and **`--save-as`**, the create command only prints details. It does not change `.env`. Verify the connection --------------------- [](#verify-the-connection) ``` php artisan db:show ``` More detail ----------- [](#more-detail) See the [documentation index](docs/README.md) for full command tables, configuration, the facade, upgrades, and workflows. Development ----------- [](#development) Clone the repository and run `composer test` if you contribute changes. Changelog --------- [](#changelog) See [CHANGELOG.md](CHANGELOG.md). Contributing ------------ [](#contributing) Contributions are welcome. Open a pull request. Security -------- [](#security) Email for security issues. Links ----- [](#links) - **SDK:** [philip/instagres](https://github.com/philip/instagres-php) - **Neon:** [Claimable Postgres](https://neon.com/docs/reference/claimable-postgres) - **Website:** [neon.com](https://neon.com) License ------- [](#license) The MIT License (MIT). See [LICENSE.md](LICENSE.md). ### Health Score 39 — LowBetter than 84% of packages Maintenance85 Actively maintained with recent releases Popularity4 Limited adoption so far Community9 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 70.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~29 days Recently: every ~36 days Total 6 Last Release 87d ago PHP version history (2 changes)v0.1.0PHP ^8.1|^8.2|^8.3|^8.4 v0.1.1PHP ^8.2|^8.3|^8.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/42943?v=4)[Philip Olson](/maintainers/philip)[@philip](https://github.com/philip) --- Top Contributors [![philip](https://avatars.githubusercontent.com/u/42943?v=4)](https://github.com/philip "philip (17 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)") --- Tags laraveldatabasepostgresqlpostgresneoninstagreslaravel-instagresclaimable-postgres ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/philip-laravel-instagres/health.svg) ``` [![Health](https://phpackages.com/badges/philip-laravel-instagres/health.svg)](https://phpackages.com/packages/philip-laravel-instagres) ``` ### Alternatives [illuminate/database The Illuminate Database package. 2.8k54.9M11.6k](/packages/illuminate-database)[spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M47](/packages/spatie-laravel-pdf)[wnx/laravel-backup-restore A package to restore database backups made with spatie/laravel-backup. 213421.0k2](/packages/wnx-laravel-backup-restore)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[lacodix/laravel-model-filter A Laravel package to filter, search and sort models with ease while fetching from database. 17558.6k](/packages/lacodix-laravel-model-filter)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 44855.7k](/packages/harris21-laravel-fuse) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)