PHPackages ryoluo/sail-ssl - 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. [DevOps & Deployment](/categories/devops) 4. / 5. ryoluo/sail-ssl ActiveLibrary[DevOps & Deployment](/categories/devops) ryoluo/sail-ssl =============== Laravel Sail plugin to enable SSL (HTTPS) connection with Nginx. v1.5.0(2mo ago)188672.6k—2.2%242MITPHPPHP ^7.3|^8.0CI passing Since Jun 7Pushed 2mo ago2 watchersCompare [ Source](https://github.com/ryoluo/sail-ssl)[ Packagist](https://packagist.org/packages/ryoluo/sail-ssl)[ RSS](/packages/ryoluo-sail-ssl/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (7)Versions (14)Used By (2) Sail-SSL ======== [](#sail-ssl) [![Version](https://camo.githubusercontent.com/f6816313931e55e8d5bf0137d395d889b10c4706f0d9770ebe02dd2316387d16/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f72796f6c756f2f7361696c2d73736c)](https://camo.githubusercontent.com/f6816313931e55e8d5bf0137d395d889b10c4706f0d9770ebe02dd2316387d16/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f72796f6c756f2f7361696c2d73736c)[![Downloads](https://camo.githubusercontent.com/7f263c337c2d4c01d93710bc46fccdef7e0f644002b0d6827d1014d7b13a39ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72796f6c756f2f7361696c2d73736c)](https://camo.githubusercontent.com/7f263c337c2d4c01d93710bc46fccdef7e0f644002b0d6827d1014d7b13a39ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72796f6c756f2f7361696c2d73736c)[![License](https://camo.githubusercontent.com/520a12adc337bc631cd54b550224970c13705aeba85b8e4d001d422532d5f762/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f72796f6c756f2f7361696c2d73736c)](https://camo.githubusercontent.com/520a12adc337bc631cd54b550224970c13705aeba85b8e4d001d422532d5f762/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f72796f6c756f2f7361696c2d73736c)[![Test](https://camo.githubusercontent.com/a83e9a5feaad7035b9f26f2aa1dee2e2ec9f171c9135600048177e6d5967ed2b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72796f6c756f2f7361696c2d73736c2f6c61726176656c2e796d6c3f6272616e63683d6d61696e266c6162656c3d74657374)](https://camo.githubusercontent.com/a83e9a5feaad7035b9f26f2aa1dee2e2ec9f171c9135600048177e6d5967ed2b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72796f6c756f2f7361696c2d73736c2f6c61726176656c2e796d6c3f6272616e63683d6d61696e266c6162656c3d74657374) A [Laravel Sail](https://github.com/laravel/sail) plugin that enables SSL (HTTPS) for your local development environment using an Nginx reverse proxy with self-signed certificates. Table of Contents ----------------- [](#table-of-contents) - [How It Works](#how-it-works) - [Requirements](#requirements) - [Installation](#installation) - [Update AppServiceProvider](#update-appserviceprovider) - [Trust the Certificate (Optional)](#trust-the-certificate-optional) - [Environment Variables](#environment-variables) - [Customize Nginx Configuration](#customize-nginx-configuration) - [Troubleshooting](#troubleshooting) - [Contributing](#contributing) - [License](#license) How It Works ------------ [](#how-it-works) Sail-SSL adds an Nginx container to your Docker Compose setup that acts as an SSL-terminating reverse proxy: ``` Browser → https://localhost:443 → Nginx (SSL termination) → http://laravel.test → Laravel App ``` Running the `sail-ssl:install` command automatically adds an Nginx service to your `docker-compose.yml`. On container startup, a self-signed Root CA and server certificate are generated, enabling HTTPS access out of the box. Requirements ------------ [](#requirements) - [Laravel Sail](https://laravel.com/docs/sail) already set up in your project - Docker and Docker Compose installed Installation ------------ [](#installation) ### With Local PHP / Composer [](#with-local-php--composer) ``` composer require ryoluo/sail-ssl --dev php artisan sail-ssl:install ./vendor/bin/sail up ``` ### With Sail Container [](#with-sail-container) ``` ./vendor/bin/sail up -d ./vendor/bin/sail composer require ryoluo/sail-ssl --dev ./vendor/bin/sail artisan sail-ssl:install ./vendor/bin/sail down ./vendor/bin/sail up ``` Once the containers are running, you can access . > **Note:** The `sail-ssl:install` command adds an Nginx service to your `docker-compose.yml` (or `compose.yaml`). If an `nginx` service already exists, the command will be skipped. Update AppServiceProvider ------------------------- [](#update-appserviceprovider) Since the application runs behind an Nginx reverse proxy that handles SSL, Laravel needs to be configured to generate HTTPS URLs. Add `URL::forceScheme('https')` to the `boot` method of your `AppServiceProvider`: ``` use Illuminate\Support\Facades\URL; public function boot(): void { URL::forceScheme('https'); } ``` Without this setting, Laravel may generate HTTP URLs for assets, routes, etc., even though the site is served over HTTPS. Trust the Certificate (Optional) -------------------------------- [](#trust-the-certificate-optional) The plugin generates a local Root CA certificate to sign the server certificate. You can import the Root CA into your browser or OS to remove the security warning. ### 1. Copy the Root CA certificate to your host machine [](#1-copy-the-root-ca-certificate-to-your-host-machine) ``` ./vendor/bin/sail cp nginx:/etc/nginx/certs/root-ca.crt . ``` ### 2. Import the certificate [](#2-import-the-certificate) OS / BrowserSteps**Chrome**Settings > Privacy and Security > Security > Manage certificates > Authorities > Import**Firefox**Settings > Privacy & Security > Security > View Certificates > Authorities > Import**macOS**Double-click `root-ca.crt` to open Keychain Access, then set "Always Trust"**Windows**Double-click `root-ca.crt` > Install Certificate > Place in "Trusted Root Certification Authorities"> **Note:** If you change `SSL_DOMAIN` or `SSL_ALT_NAME`, remove the Docker volume to regenerate certificates: > > ``` > docker volume rm sail-nginx > ``` Environment Variables --------------------- [](#environment-variables) You can customize the behavior by setting the following environment variables in your `.env` file: VariableDescriptionDefault`SERVER_NAME`Value for the `server_name` directive in nginx.conf`localhost``APP_SERVICE`Laravel service name defined in docker-compose.yml`laravel.test``HTTP_PORT`Nginx HTTP port (requests to this port are redirected to `SSL_PORT`)`8000``SSL_PORT`Nginx HTTPS port`443``SSL_DOMAIN`Common Name (CN) for the SSL certificate (e.g. `*.mydomain.test`). Set this when using a domain other than `localhost``localhost``SSL_ALT_NAME`Subject Alternative Name (SAN) for the SSL certificate (e.g. `DNS:localhost,DNS:mydomain.test`). Set this when using a domain other than `localhost``DNS:localhost`### Custom Domain Example [](#custom-domain-example) To access your app via `mydomain.test`, add the following to your `.env`: ``` SERVER_NAME=mydomain.test SSL_DOMAIN=mydomain.test SSL_ALT_NAME=DNS:mydomain.test,DNS:localhost ``` Then add an entry to your hosts file (`/etc/hosts` on macOS/Linux, `C:\Windows\System32\drivers\etc\hosts` on Windows): ``` 127.0.0.1 mydomain.test ``` Customize Nginx Configuration ----------------------------- [](#customize-nginx-configuration) You can publish the default Nginx configuration template to your project for customization: ``` php artisan sail-ssl:publish ``` This copies `default.conf.template` to `./nginx/templates/` in your project root and automatically updates the volume mount in `docker-compose.yml`. You can use environment variables such as `${SERVER_NAME}` and `${APP_SERVICE}` directly in the template file. Troubleshooting --------------- [](#troubleshooting) ### Port Conflicts [](#port-conflicts) If `SSL_PORT` or `HTTP_PORT` conflicts with another service, change them in your `.env`: ``` HTTP_PORT=8080 SSL_PORT=4443 ``` ### Regenerate Certificates [](#regenerate-certificates) Remove the Docker volume and restart the containers: ``` docker volume rm sail-nginx ./vendor/bin/sail up ``` ### Assets or Links Generated with HTTP [](#assets-or-links-generated-with-http) Make sure you have configured `URL::forceScheme('https')` in your `AppServiceProvider`. See [Update AppServiceProvider](#update-appserviceprovider) for details. Contributing ------------ [](#contributing) Pull requests are welcome! For bug reports and feature requests, please open an [Issue](https://github.com/ryoluo/sail-ssl/issues). License ------- [](#license) [MIT License](LICENSE) ### Health Score 59 — FairBetter than 99% of packages Maintenance83 Actively maintained with recent releases Popularity56 Moderate usage in the ecosystem Community24 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 71.9% 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 ~135 days Recently: every ~177 days Total 11 Last Release 87d ago PHP version history (3 changes)v1.0.0PHP ^7.3|^8.0 v1.2.0PHP ^7.3|^8.0|^8.1|^8.2 v1.3.1PHP ^7.3|^8.0|^8.1|^8.2|^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/525b954048abe70142c7ea33f27bb7407b52c044015ed6142de88fb38cf7fc53?d=identicon)[ryoluo](/maintainers/ryoluo) --- Top Contributors [![ryoluo](https://avatars.githubusercontent.com/u/40686845?v=4)](https://github.com/ryoluo "ryoluo (41 commits)")[![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?v=4)](https://github.com/devin-ai-integration[bot] "devin-ai-integration[bot] (6 commits)")[![michaelservidio](https://avatars.githubusercontent.com/u/26412832?v=4)](https://github.com/michaelservidio "michaelservidio (5 commits)")[![kasparasg](https://avatars.githubusercontent.com/u/1433383?v=4)](https://github.com/kasparasg "kasparasg (1 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")[![sharafat](https://avatars.githubusercontent.com/u/810435?v=4)](https://github.com/sharafat "sharafat (1 commits)")[![go0baahh](https://avatars.githubusercontent.com/u/17992629?v=4)](https://github.com/go0baahh "go0baahh (1 commits)")[![janar153](https://avatars.githubusercontent.com/u/712648?v=4)](https://github.com/janar153 "janar153 (1 commits)") --- Tags httpslaravellaravel-sailnginxphpssllaravelssldockernginxsail ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/ryoluo-sail-ssl/health.svg) ``` [![Health](https://phpackages.com/badges/ryoluo-sail-ssl/health.svg)](https://phpackages.com/packages/ryoluo-sail-ssl) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k186.9M1.0k](/packages/laravel-sail)[laravel/roster Detect packages & approaches in use within a Laravel project 15510.4M7](/packages/laravel-roster)[yoelpc4/laravel-sail-preset Laravel Sail runtimes & docker-compose.yml preset. 1429.2k](/packages/yoelpc4-laravel-sail-preset) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)