Programster's Blog

Tutorials focusing on Linux, programming, and open-source

Add Satis Registry To A Project

After having taken the time to set up your own Satis server, it is not much use unless your PHP projects can use it as well as, or instead of Packagist. This tutorial shows you how to do that.

Steps

Simply add the following chunk to the top of your composer.json file:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://satis.mydomain.com/"
        }
    ],

You will need to change satis.mydomain.com to the URL of your Satis server.

If you don't have SSL enabled on your Satis package registry, then you need to also include a configuration to tell composer to not require secure HTTP connections like so:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://satis.mydomain.com/"
        }
    ],
    "config": {
        "secure-http": false
    },

Disabling Packagist

If you wish to prevent your project from using Packagist at all, then add the following block to your repositories:

{
    "packagist.org": false
},

For example:

{
    "repositories": [
        {
            "packagist.org": false
        },
        {
            "type": "composer",
            "url": "https://satis.mydomain.com/"
        }
    ],
Last updated: 23rd July 2025
First published: 23rd July 2025

This blog is created by Stuart Page

I'm a freelance web developer and technology consultant based in Surrey, UK, with over 10 years experience in web development, DevOps, Linux Administration, and IT solutions.

Need support with your infrastructure or web services?

Get in touch