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 2d 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

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

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

1540d 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

[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[gehrisandro/tailwind-merge-laravel

TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them

341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[nickurt/laravel-akismet

Akismet for Laravel 11.x/12.x/13.x

97139.6k2](/packages/nickurt-laravel-akismet)[whitecube/laravel-timezones

Store UTC dates in the database and work with custom timezones in the application.

106106.2k](/packages/whitecube-laravel-timezones)[forxer/laravel-gravatar

A library providing easy gravatar integration in a Laravel project.

4235.6k](/packages/forxer-laravel-gravatar)[iteks/laravel-enum

A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications.

2516.7k](/packages/iteks-laravel-enum)

PHPackages © 2026

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