velkolevski/cloud-gallery-made-by-velin repository overview

⁠Cloud Gallery — OCI Installation Guide

Cloud Gallery is distributed as a Docker Compose OCI artifact. This means that you do not need to download the source code or a docker-compose.yml file. Docker retrieves the application definition, the Spring Boot image, and the PostgreSQL image from the registry.

Your Cloud Gallery accounts, saved application data, and AWS configuration are stored by PostgreSQL in a local Docker volume on your machine. Your uploaded images remain in your personal S3 bucket. None of this user data is included in the downloaded application image or shared with other installations.

⁠Requirements

• Docker Desktop with Docker Compose
• Docker Desktop must be running

Check that Docker Compose is available:

docker compose version

⁠1. Create a local installation folder

Create an empty folder for your Cloud Gallery configuration and open a terminal inside it:

mkdir cloud-gallery
cd cloud-gallery

The folder will contain only your private .env configuration file. The application itself remains in Docker.

⁠2. Create the environment file

Create a file named .env inside the cloud-gallery folder with the following content:

APP_PORT=8080
POSTGRES_DB=cloud_gallery
POSTGRES_USER=cloud_gallery
POSTGRES_PASSWORD=replace_with_a_strong_unique_password

Replace replace_with_a_strong_unique_password with your own strong password. On macOS or Linux, you can generate one with:

openssl rand -hex 32

Paste the generated value after POSTGRES_PASSWORD=. Do not add spaces around the = sign.

The password protects this installation's PostgreSQL database. It is not your Cloud Gallery login password. Do not share or commit the .env file.

You may change APP_PORT if port 8080 is already in use. For example:

APP_PORT=8082

⁠3. Start Cloud Gallery for the first time

Run the following command from the folder that contains .env:

docker compose --env-file .env -p cloud-gallery -f oci://docker.io/velkolevski/cloud-gallery-made-by-velin:compose-1.0.0 up -d

Docker Compose may show the variables used by the OCI artifact and ask for confirmation. Check that APP_PORT, POSTGRES_DB, POSTGRES_USER, and POSTGRES_PASSWORD are set, then enter y to continue only if you trust the artifact source.

Docker downloads and starts two containers:

• Cloud Gallery — the Spring Boot application
• PostgreSQL — the private database for this installation

PostgreSQL starts first. Cloud Gallery starts after the database becomes healthy.

⁠4. Open the application

If .env contains APP_PORT=8080, open:

http://localhost:8080