PHPackages                             filhocodes/laravel-sail-ssl-proxy - 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. [Utility & Helpers](/categories/utility)
4. /
5. filhocodes/laravel-sail-ssl-proxy

ActiveLibrary[Utility & Helpers](/categories/utility)

filhocodes/laravel-sail-ssl-proxy
=================================

Somewhat easy solution to add SSL to Sail environments

v1.0.0(4y ago)06MITPHPPHP ^8.1

Since Feb 23Pushed 4y ago1 watchersCompare

[ Source](https://github.com/filhocodes/laravel-sail-ssl-proxy)[ Packagist](https://packagist.org/packages/filhocodes/laravel-sail-ssl-proxy)[ RSS](/packages/filhocodes-laravel-sail-ssl-proxy/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

FilhoCodes' Laravel Sail SSL Proxy
==================================

[](#filhocodes-laravel-sail-ssl-proxy)

[![Composer Package](https://camo.githubusercontent.com/1694480349927a0aa8245b1c427f605c0d010a4f950aaed4a7beb3f2ccee847d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696c686f636f6465732f6c61726176656c2d7361696c2d73736c2d70726f7879)](https://packagist.org/packages/filhocodes/laravel-sail-ssl-proxy)[![Composer Package Downloads](https://camo.githubusercontent.com/b442e3cc060084be7369f607a20530f9c5cd78a1d39cd7f585e7957b3fd751d5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66696c686f636f6465732f6c61726176656c2d7361696c2d73736c2d70726f7879)](https://packagist.org/packages/filhocodes/laravel-sail-ssl-proxy)

An easy and ready way to configure a proxy that allows you to host local projects using Laravel Sail via HTTPS.

The design of the SSL proxy was taken from . Basically, Caddy will be executed on top of the Laravel Server, and will generate a local certificate. Then you can add this certificate to your local trusted store.

Quick usage
-----------

[](#quick-usage)

If you don't have a local installation of PHP and Composer, you can use this alias to execute both via docker

```
alias sail81 = 'mkdir -p $HOME/.sail/81/.composer/ && docker run --rm -it -u "$(id -u):$(id -g)" -v $HOME/.sail/81/.composer:/.composer -v $(pwd):/opt -w /opt laravelsail/php81-composer:latest'
```

Then you can just prepend the commands bellow with `sail81`:

```
# Running composer
sail81 composer {...}

# Running an artisan command
sail81 php artisan {...}
```

Before setting up the proxy, Laravel Sail shall already be configured in your project. Installations made using the script provided by the [Laravel Documentation](https://laravel.com/docs/9.x/installation#your-first-laravel-project)will already have a Laravel Sail environment. Other than that, you will need to configure it yourself. Please refer to the [Laravel Sail Documentation](https://laravel.com/docs/9.x/sail) to do so.

With your project using Laravel Sail, require this package using Composer:

```
composer require --dev filhocodes/laravel-sail-ssl-proxy
```

Then install the proxy service using the following command:

```
php artisan ssl-proxy:install -m

# -m will write a logic into app/Http/Middleware/TrustProxies.php to trust the SSL proxy.
# You may update this logic as you wish, or you can omit the option so that the file is not modified.
# In either case, is recommended in development to trust the reverse proxy
```

After that, spin up the development environment:

```
./vendor/bin/sail up -d

# If you are using our custom logic to trust the SSL proxy, after the containers are booted up, you may use the
# following command to retrieve the SSL proxy IP (will not work on Windows):
#     ./vendor/bin/filhocodes-ssl-proxy-env
```

After your first HTTP request to the application, a certificate will be created at `docker/sail-ssl-proxy/authorities/intermediate.crt`. You can then add this certificate to your trusted store. In Linux, you may use the command `./vendor/bin/filhocodes-ssl-proxy-trust` to add the certificate to the system store.

If the authorities certificates are generated, but the `certificates` directory is empty, this probably means that the authorization flow was unsuccessful. This will mostly be due to the domain check. By default, we use parse the domain of the Application URL, defined via the `app.url` config (and the default `APP_URL` environment variable). If needed, you can publish our config and update the value via the `authorized_domains` config.

```
php artisan vendor:publish --tag=filhocodes-ssl-proxy-config
```

You can also set the environment variable `FILHOCODES_LARAVEL_SAIL_SSL_PROXY_DEBUG=true` to log the request made to the authorization controller.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1592d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5cc209810b516ba21283ceb79a3f59064948589bb5cb93f6f0680932145d5c38?d=identicon)[marcossffilho](/maintainers/marcossffilho)

---

Top Contributors

[![filhocodes](https://avatars.githubusercontent.com/u/4489182?v=4)](https://github.com/filhocodes "filhocodes (4 commits)")

---

Tags

laravelsslsail

### Embed Badge

![Health badge](/badges/filhocodes-laravel-sail-ssl-proxy/health.svg)

```
[![Health](https://phpackages.com/badges/filhocodes-laravel-sail-ssl-proxy/health.svg)](https://phpackages.com/packages/filhocodes-laravel-sail-ssl-proxy)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M984](/packages/statamic-cms)[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

3.0k37.6M134](/packages/darkaonline-l5-swagger)[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k14.2M63](/packages/knuckleswtf-scribe)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[firefly-iii/data-importer

Firefly III Data Import Tool.

8035.8k](/packages/firefly-iii-data-importer)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17878.9k](/packages/markwalet-nova-modal-response)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)