Satis — Bootstrap¶

How to set up the Satis server from scratch on a new host.

Prerequisites¶

Before starting, ensure the following are in place on the host machine:

Requirement	Details
Docker & Docker Compose	Installed and running
SSH keys	A valid SSH key pair with read access to the Bitbucket repositories listed in `satis.json`
`.env` file	See variables below

.env variables:

Variable	Description
`WEB_PORT`	Port the web server listens on (e.g. `90`)
`SSH_PRIVATE_KEY_PATH`	Local path to the SSH private key
`SSH_PUBLIC_KEY_PATH`	Local path to the SSH public key

1. Clone the repository

Clone the Satis server repository onto the production host.

2. Configure the environment

Create a .env file in the project root with the variables listed above.

3. Launch the containers

docker-compose up -d --build

4. Run the initial Satis build

./update-satis.sh

This triggers the first index build. After this, the registry is live and packages can be resolved.

Subsequent updates are handled automatically by the Bitbucket Pipeline on every push to the repository.