Skip to content
/ satis Public

Simple static Composer repository generator - For a full private Composer repo use Private Packagist

License

Notifications You must be signed in to change notification settings

composer/satis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Feb 20, 2025
f14cee1 · Feb 20, 2025
Dec 24, 2024
Mar 23, 2022
Oct 11, 2022
Dec 24, 2024
Sep 27, 2024
Sep 28, 2024
Sep 28, 2024
Sep 18, 2023
Dec 24, 2024
Mar 9, 2018
Feb 16, 2021
Oct 11, 2021
May 6, 2019
Sep 15, 2023
Sep 11, 2023
Jul 6, 2021
Mar 23, 2022
Feb 16, 2021
Oct 21, 2021
Oct 12, 2016
Dec 24, 2024
Sep 27, 2024
Feb 17, 2025
Feb 17, 2025
Nov 19, 2024
Feb 20, 2025
Feb 20, 2025
Sep 4, 2018
Sep 18, 2023
Sep 25, 2023
Oct 29, 2020
Dec 24, 2024

Repository files navigation

Satis

A simple static Composer repository generator.

About

Satis is a tool that allows PHP developers to create a private package repository for their projects' dependencies. It provides increased control over package distribution, improved security, and faster package installations, by creating a static Composer registry that can be hosted anywhere (even via Docker, locally).

Run from source

Satis requires a recent PHP version, it does not run with unsupported PHP versions. Check the composer.json file for details.

  • Install Satis: composer create-project --keep-vcs --no-dev composer/satis:dev-main
  • Build a repository: php bin/satis build <configuration-file> <output-directory>

Read the more detailed instructions in the documentation.

Run as Docker container

Note: use composer/satis for Docker Hub, ghcr.io/composer/satis for GitHub container registry.

Pull the image:

docker pull composer/satis

Run the image (with Composer cache from host):

docker run --rm --init -it \
  --user $(id -u):$(id -g) \
  --volume $(pwd):/build \
  --volume "${COMPOSER_HOME:-$HOME/.composer}:/composer" \
  composer/satis build <configuration-file> <output-directory>

If you want to run the image without implicitly running Satis, you have to override the entrypoint specified in the Dockerfile:

--entrypoint /bin/sh

Purge

If you choose to archive packages as part of your build, over time you can be left with useless files. With the purge command, you can delete these files.

php bin/satis purge <configuration-file> <output-dir>

Note: don't do this unless you are certain your projects no longer reference any of these archives in their composer.lock files.

Updating

Updating Satis is as simple as running git pull && composer install in the Satis directory.

If you are running Satis as a Docker container, simply pull the latest image.

Contributing

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Fork the project, create a feature branch, and send us a pull request.

If you introduce a new feature, or fix a bug, please try to include a testcase.

While not required, it is appreciated if your contribution meets our coding standards.

You can check these yourself by running the tools we use:

# install tooling & dependencies
for d in tools/*; do composer --working-dir=$d install; done

# run php-cs-fixer
tools/php-cs-fixer/vendor/bin/php-cs-fixer fix

# run phpstan
tools/phpstan/vendor/bin/phpstan

# alternatively, use the shortcuts
composer phpstan
composer php-cs-fixer[-fix]

Authors

See the list of contributors who participate(d) in this project.

Community Tools

  • satisfy - Symfony based composer repository manager with a simple web UI.

Examples

License

Satis is licensed under the MIT License - see the LICENSE file for details