PHPackages serversideup/spin - 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. serversideup/spin ActiveLibrary[DevOps & Deployment](/categories/devops) serversideup/spin ================= Replicate your production environment locally using Docker. Just run "spin up". It's really that easy. v3.1.1(6mo ago)1.5k54.3k↓28.1%64[3 issues](https://github.com/serversideup/spin/issues)[1 PRs](https://github.com/serversideup/spin/pulls)GPL-3.0-or-laterShellCI passing Since Jan 13Pushed 2mo ago12 watchersCompare [ Source](https://github.com/serversideup/spin)[ Packagist](https://packagist.org/packages/serversideup/spin)[ GitHub Sponsors](https://github.com/serversideup)[ RSS](/packages/serversideup-spin/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)DependenciesVersions (67)Used By (0) [![Spin Header](.github/small-header.png)](https://serversideup.net/open-source/spin/) [![Spin Header](https://raw.githubusercontent.com/serversideup/media-assets/main/spin/spin-demo_spin-up.gif)](https://serversideup.net/open-source/spin/) [![Build Status](https://camo.githubusercontent.com/9ccf675ac847e105ac1a8a1aecfa01d99959508826fc54f6fb183d7636fb8092/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e742e7376673f75726c3d6874747073253341253246253246616374696f6e732d62616467652e6174726f782e6465762532467365727665727369646575702532467370696e25324662616467652533467265662533446d61696e267374796c653d666c6174)](https://actions-badge.atrox.dev/serversideup/spin/goto?ref=main) [![License](https://camo.githubusercontent.com/3b4ddd92d13f704394b8cc46f4cb564bbdc0e5f03abdacc6afd82957aaf7fc22/68747470733a2f2f62616467656e2e6e65742f6769746875622f6c6963656e73652f7365727665727369646575702f7370696e)](https://github.com/serversideup/spin/blob/main/LICENSE) [![Support us](https://camo.githubusercontent.com/30ecf363a212183cf52863b309c405e06efecfc813436b733982c7dfb5b52633/68747470733a2f2f62616467656e2e6e65742f62616467652f69636f6e2f537570706f727425323055733f6c6162656c3d47697448756225323053706f6e736f727326636f6c6f723d6f72616e6765)](https://github.com/sponsors/serversideup) [![npm](https://camo.githubusercontent.com/091eac055c6afcca53822dca8379ec7ef7c77a6f79871770d74fde203fd2f5ef/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f646d2f407365727665727369646575702f7370696e3f636f6c6f723d726564266c6162656c3d646f776e6c6f616473266c6f676f3d6e706d)](https://www.npmjs.com/package/@serversideup/spin) [![Packagist Downloads](https://camo.githubusercontent.com/fc3e8daa7246fdc5d9cf914fcc592b0a168a9c32f957d36291b32116441fce23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f7365727665727369646575702f7370696e3f636f6c6f723d626c7565266c6f676f3d7061636b6167697374)](https://packagist.org/packages/serversideup/spin) [![Discourse users](https://camo.githubusercontent.com/120c3bfc6dd7db292a0f6dfeacf16cf5f966652eeae46fdb1767d22b93106c3a/68747470733a2f2f696d672e736869656c64732e696f2f646973636f757273652f75736572733f636f6c6f723d626c7565267365727665723d6874747073253341253246253246636f6d6d756e6974792e7365727665727369646575702e6e6574)](https://community.serversideup.net) [![Discord](https://camo.githubusercontent.com/b49a4de4817d15ee68fd987a0b5b866c416b2db144d3280d5d2bccb1df4b7a86/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3931303238373130353731343935343235313f636f6c6f723d626c756576696f6c6574)](https://serversideup.net/discord) Introduction ============ [](#introduction) **Stop wasting time fixing production issues you've already solved.** Spin is a bash utility that improves the user-experience for teams using Docker. Replicate any environment on any machine, regardless if they are running MacOS, Windows, or Linux. Centralize your infrastructure from a single configuration file using Docker. Spin is a wrapper script that dramatically improves the developer experience when working with Docker. Spin uses officially supported features and best practices from Docker. **Features** ![Replicate in any Environment](https://camo.githubusercontent.com/e6500069ec2e91cceb1b3e2215d72f4d6b1ffd570ee8c6d1edec5cc327f17e82/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f7265706c69636174652e706e67)![Runs on Mac, Windows, Linux](https://camo.githubusercontent.com/9de0a444427988330515db9035740b015125396b6b7fdb59d816bdc7f5bba5f4/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f72756e2d6f6e2d616e797468696e672e706e67)![Choose Any Host](https://camo.githubusercontent.com/6587463b991f514da001be453784e653f8e13e228bf47147877f298a46bf432a/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f63686f6f73652d616e792d686f73742e706e67)![Framework Agnostic](https://camo.githubusercontent.com/130d559e943ec5c40a6ef7ed66c4bd240cc962f19adb6bf38c926e2b76844af8/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f6672616d65776f726b2d61676e6f737469632e706e67)![Zero-downtime Deployments](https://camo.githubusercontent.com/14675249f479477e6688712315fe3e8f0c6eb83651f08401eeada149ec5012f9/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f7a65726f2d646f776e74696d652d6465706c6f796d656e74732e706e67)![Docker Syntax Simplified](https://camo.githubusercontent.com/fac81f78e582282463b102e392c420f56ba5503b3818448ce70e5b5f9164c974/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f646f636b65722d73696d706c69666965642e706e67)![Simple Server Management](https://camo.githubusercontent.com/6730918c08c13c8d68723ffbc35e41e6a34c4b2e5c139e7ddab85ebfe18006da/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f73696d706c652d7365727665722d6d616e6167656d656e742e706e67)![GitHub Action Support](https://camo.githubusercontent.com/0534c63f2e5c558c2d641c126b0d64934be479469e8b804e2e21153b6d5498be/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f6769746875622d616374696f6e2d737570706f72742e706e67)![Automated SSL](https://camo.githubusercontent.com/f2017b0bdbe770ac8cf585520299095c34e68bcaf3b901901883ea220745878f/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f30312f6175746f6d617465642d73736c2e706e67)Installation & Usage ------------------------ [](#installation--usage) Spin is flexible and able to be installed via: - [macOS](https://serversideup.net/open-source/spin/docs/installation/install-macos) - [Windows](https://serversideup.net/open-source/spin/docs/installation/install-windows) - [Linux](https://serversideup.net/open-source/spin/docs/installation/install-linux) - [Composer](https://serversideup.net/open-source/spin/docs/installation/install-composer) - [NPM/Yarn](https://serversideup.net/open-source/spin/docs/installation/install-npm-yarn) ### Simple Install Command [](#simple-install-command) ``` bash -c "$(curl -fsSL https://raw.githubusercontent.com/serversideup/spin/main/tools/install.sh)" ``` ### Create a new project [](#create-a-new-project) Spin has `spin new` to create a new project with Spin installed, as well as `spin init` to add Spin to an existing project. ``` spin new laravel {{ your project name }} ``` Looking for more features? -------------------------- [](#looking-for-more-features) We have a "[Spin Pro Laravel Template](https://getspin.pro)" that includes more features for Laravel Pros: FeatureSpin Basic Laravel TemplateSpin Pro Laravel TemplatePriceFree$199/once (lifetime access)Automated Deployments with GitHub Actions❌✅Local Development SSL❌✅ (Trusted)Tunnel Support❌✅SMTP Trapping❌✅ (Mailpit)Vite over HTTPS❌✅DatabasesSQLite✅ MariaDB, MySQL, PostgreSQL, SQLiteRedis❌✅Laravel Horizon❌✅Laravel Reverb❌✅Laravel Queues❌✅Mailpit over HTTPS❌✅Node Package Manager`yarn``yarn` or `npm`Support✅ Discord, GitHub Discussions✅ Private Community SupportIf you're interested in the Pro version, you visit for more information. How Spin Works -------------- [](#how-spin-works) Spin serves as a collection of open source technologies, put together in one simple experience. [![](./.github/spin-diagram.png)](./.github/spin-diagram.png) #### Spin uses these proven technologies [](#spin-uses-these-proven-technologies) - [Docker](https://www.docker.com/) (Docker Desktop, Docker Compose, Docker Swarm Mode) - [Ansible](https://www.ansible.com/) - Includes [GitHub Actions](https://docs.github.com/en/actions) templates (but can work with [GitLab CI](https://docs.gitlab.com/ee/ci/) too) #### We also use a number of our other open source projects in Spin [](#we-also-use-a-number-of-our-other-open-source-projects-in-spin) - [Spin Ansible Collection](https://github.com/serversideup/ansible-collection-spin) - Used to provision and maintain your production server. - [serversideup/docker-build-action](https://github.com/marketplace/actions/docker-build-action) - A simplified syntax to build and publish your Docker images with GitHub Actions. - [serversideup/docker-swarm-deploy-github-action](https://github.com/marketplace/actions/docker-swarm-deploy-github-action) - A simplified syntax to deploy to Docker Swarm Mode via GitHub Actions. - [serversideup/php](https://serversideup.net/open-source/docker-php/) - PHP Docker images highly optimized to work with Laravel + Spin. - [serversideup/docker-ssh](https://github.com/serversideup/docker-ssh) - A lightweight docker image that runs SSH. This is a fantastic method on using a secure SSH tunnel into your database cluster. - [serversideup/docker-ansible](https://github.com/serversideup/docker-ansible) - A lightweight docker image that runs Ansible. - [serversideup/docker-github-cli](https://github.com/serversideup/docker-github-cli) - A lightweight docker image that runs GitHub CLI. Resources --------- [](#resources) - **[Website](https://serversideup.net/open-source/spin/)** overview of the product. - **[Docs](https://serversideup.net/open-source/spin/docs)** for a deep-dive on how to use the product. - **[Discord](https://serversideup.net/discord)** for friendly support from the community and the team. - **[GitHub](https://github.com/serversideup/spin)** for source code, bug reports, and project management. - **[Get Professional Help](https://serversideup.net/professional-support)** - Get video + screen-sharing help directly from the core contributors. Contributing ------------ [](#contributing) As an open-source project, we strive for transparency and collaboration in our development process. We greatly appreciate any contributions members of our community can provide. Whether you're fixing bugs, proposing features, improving documentation, or spreading awareness - your involvement strengthens the project. Please review our [contribution guidelines](https://serversideup.net/open-source/spin/docs/community/contributing) and [code of conduct](./.github/code_of_conduct.md) to understand how we work together respectfully. - **Bug Report**: If you're experiencing an issue while using these images, please [create an issue](https://github.com/serversideup/spin/issues/new/choose). - **Feature Request**: Make this project better by [submitting a feature request](https://github.com/serversideup/spin/discussions/9). - **Documentation**: Improve our documentation by [submitting a documentation change](./docs/README.md). - **Community Support**: Help others on [GitHub Discussions](https://github.com/serversideup/spin/discussions) or [Discord](https://serversideup.net/discord). - **Security Report**: Report critical security issues via [our responsible disclosure policy](https://www.notion.so/Responsible-Disclosure-Policy-421a6a3be1714d388ebbadba7eebbdc8). Need help getting started? Join our Discord community and we'll help you out! [![](https://camo.githubusercontent.com/e21c799862908e47e04352ba3cac3a340544f3d69db3ae00dd660cb7c96d5ead/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f7468656d65732f7365727665727369646575702f696d616765732f6f70656e2d736f757263652f6a6f696e2d646973636f72642e737667 "Join Discord")](https://serversideup.net/discord) Our Sponsors ------------ [](#our-sponsors) All of our software is free an open to the world. None of this can be brought to you without the financial backing of our sponsors. [![Sponsors](https://camo.githubusercontent.com/d4a426619ade78b3f1db819e0c41e79dd4a5af6a2a172f4b7e19ff9bdc335fa4/68747470733a2f2f3532317075626c69632e73332e616d617a6f6e6177732e636f6d2f7365727665727369646575702f73706f6e736f72732f73706f6e736f722d626f782e706e67)](https://github.com/sponsors/serversideup) ### Black Level Sponsors [](#black-level-sponsors) [![Sevalla](https://camo.githubusercontent.com/32163eb8b7b84230056b6f7e1076349ce5660bac28e00c60c45d2508a9095473/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032342f31302f73706f6e736f722d696d6167652e706e67)](https://sevalla.com) #### Individual Supporters [](#individual-supporters) [![aagjalpankaj](https://github.com/aagjalpankaj.png)](https://github.com/aagjalpankaj)About Us -------- [](#about-us) We're [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers) - a two person team with a passion for open source products. We created [Server Side Up](https://serversideup.net) to help share what we learn. Dan Pastori Jay Rogers [![](https://camo.githubusercontent.com/553aefbe4cab1fd53359adff3b588d05a03f6ba1e540043282991ca668aeef4d/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032332f30382f64616e2e6a7067 "Dan Pastori")](https://twitter.com/danpastori) [![](https://camo.githubusercontent.com/5ef0d67bcbac856a8c9d96e1099ce12b823682e963c430471500f1ec5c124eb1/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f7468656d65732f7365727665727369646575702f696d616765732f6f70656e2d736f757263652f747769747465722e737667 "Twitter")](https://twitter.com/danpastori)[![](https://camo.githubusercontent.com/6a8c2eeef9ceaba1c3ef3db1abceb9e8952339aee1dc9e4b4ede5ec2224b2db6/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f7468656d65732f7365727665727369646575702f696d616765732f6f70656e2d736f757263652f6769746875622e737667 "GitHub")](https://github.com/danpastori) [![](https://camo.githubusercontent.com/065423f56899ebfb34930bbb3cf58ad2a406cb8328bc8ae8277e1e370c9835d4/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f75706c6f6164732f323032332f30382f6a61792e6a7067 "Jay Rogers")](https://twitter.com/jaydrogers) [![](https://camo.githubusercontent.com/5ef0d67bcbac856a8c9d96e1099ce12b823682e963c430471500f1ec5c124eb1/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f7468656d65732f7365727665727369646575702f696d616765732f6f70656e2d736f757263652f747769747465722e737667 "Twitter")](https://twitter.com/jaydrogers)[![](https://camo.githubusercontent.com/6a8c2eeef9ceaba1c3ef3db1abceb9e8952339aee1dc9e4b4ede5ec2224b2db6/68747470733a2f2f7365727665727369646575702e6e65742f77702d636f6e74656e742f7468656d65732f7365727665727369646575702f696d616765732f6f70656e2d736f757263652f6769746875622e737667 "GitHub")](https://github.com/jaydrogers) ### Find us at: [](#find-us-at) - **📖 [Blog](https://serversideup.net)** - Get the latest guides and free courses on all things web/mobile development. - **🙋 [Community](https://community.serversideup.net)** - Get friendly help from our community members. - **🤵‍♂️ [Get Professional Help](https://serversideup.net/professional-support)** - Get video + screen-sharing support from the core contributors. - **💻 [GitHub](https://github.com/serversideup)** - Check out our other open source projects. - **📫 [Newsletter](https://serversideup.net/subscribe)** - Skip the algorithms and get quality content right to your inbox. - **🐥 [Twitter](https://twitter.com/serversideup)** - You can also follow [Dan](https://twitter.com/danpastori) and [Jay](https://twitter.com/jaydrogers). - **❤️ [Sponsor Us](https://github.com/sponsors/serversideup)** - Please consider sponsoring us so we can create more helpful resources. Our products ------------ [](#our-products) If you appreciate this project, be sure to check out our other projects. ### 📚 Books [](#-books) - **[The Ultimate Guide to Building APIs & SPAs](https://serversideup.net/ultimate-guide-to-building-apis-and-spas-with-laravel-and-nuxt3/)**: Build web & mobile apps from the same codebase. - **[Building Multi-Platform Browser Extensions](https://serversideup.net/building-multi-platform-browser-extensions/)**: Ship extensions to all browsers from the same codebase. ### 🛠️ Software-as-a-Service [](#️-software-as-a-service) - **[Bugflow](https://bugflow.io/)**: Get visual bug reports directly in GitHub, GitLab, and more. - **[SelfHost Pro](https://selfhostpro.com/)**: Connect Stripe or Lemonsqueezy to a private docker registry for self-hosted apps. ### 🌍 Open Source [](#-open-source) - **[serversideup/php Docker Images](https://serversideup.net/open-source/docker-php/)**: PHP Docker images optimized for Laravel and running PHP applications in production. - **[Financial Freedom](https://github.com/serversideup/financial-freedom)**: Open source alternative to Mint, YNAB, & Monarch Money. - **[AmplitudeJS](https://521dimensions.com/open-source/amplitudejs)**: Open-source HTML5 & JavaScript Web Audio Library. ### Health Score 58 — FairBetter than 98% of packages Maintenance76 Regular maintenance activity Popularity56 Moderate usage in the ecosystem Community23 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 94.3% 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 ~22 days Recently: every ~74 days Total 64 Last Release 193d ago Major Versions v0.1.3 → v1.0.02022-01-26 v1.1.0 → v2.0.0-alpha-22023-05-08 v2.3.0 → v3.0.0-beta12024-10-25 ### Community Maintainers ![](https://www.gravatar.com/avatar/22c0cabd5df52b68eb1af51077a850ce1573ab7a450a0244b818bcb86e487bba?d=identicon)[jaydrogers](/maintainers/jaydrogers) --- Top Contributors [![jaydrogers](https://avatars.githubusercontent.com/u/3174134?v=4)](https://github.com/jaydrogers "jaydrogers (264 commits)")[![danpastori](https://avatars.githubusercontent.com/u/2365103?v=4)](https://github.com/danpastori "danpastori (11 commits)")[![nexxai](https://avatars.githubusercontent.com/u/4316564?v=4)](https://github.com/nexxai "nexxai (1 commits)")[![oldskool73](https://avatars.githubusercontent.com/u/967801?v=4)](https://github.com/oldskool73 "oldskool73 (1 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")[![JoeCianflone](https://avatars.githubusercontent.com/u/989648?v=4)](https://github.com/JoeCianflone "JoeCianflone (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") --- Tags development-environmentdevopsdockerdocker-composedocker-swarmlaravelnodejs ### Embed Badge ![Health badge](/badges/serversideup-spin/health.svg) ``` [![Health](https://phpackages.com/badges/serversideup-spin/health.svg)](https://phpackages.com/packages/serversideup-spin) ``` ### Alternatives [deployer/deployer Deployment Tool 11.1k25.4M207](/packages/deployer-deployer)[appwrite/server-ce End to end backend server for frontend and mobile apps. 55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health Laravel Server & App Health Monitor and Notifier 2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol PHP classes for the Language Server Protocol 22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku 8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2 PHPAS2 is a php-based implementation of the EDIINT AS2 standard 4674.7k](/packages/tiamo-phpas2) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)