Overview

Light Store can be installed using Docker & docker-compose.

This is the recommended installation method as it provides:

• OS-agnostic deployment
• Pre-configured components (PostgreSQL, Redis, Adminer, etc.)
• Isolated environment
• Easy updates and maintenance

INFO

This way of installing the store has been superseded by using an automatic script, which also uses Docker for installation and additionally, automatically configures a reverse proxy with HTTPS support.

However, this method of installation is still recommended for systems other than Ubuntu Linux.

Installing Docker

You'll need Docker and docker-compose installed on your system. Choose your platform below:

• Linux (most servers): Follow the Docker Engine Installation Guide for your specific distribution or run this convincience script to get started quickly:

curl -fsSL https://get.docker.com | sudo sh

• Windows: Install Docker Desktop for Windows

• Mac: Install Docker Desktop for Mac

Installing Light Store

Now that Docker is set up, you can proceed with installing Light Store:

1. Download the Light Store package from BuiltByBit

2. Extract the package:

   unzip Light\ Store\ v*.*.zip
   cd Light\ Store\ v*.*

3. Start the containers:

   docker compose up -d --build

4. Configure the reverse proxy:

   • For HTTP: Use http://your-server-ip:8001 (default port)
   • For HTTPS: Check our Nginx with SSL guide for setting up HTTPS for the store

   Custom Port

   The default port (8001) can be modified in docker-compose.yml if needed.

5. Enter the page and follow the installation steps.

Managing Your Installation

Here are some useful commands for managing your Light Store installation:

# (Re)start store
docker compose up -d --build
# The --build flag may be ommited if no code changes have been made.
# However, it is recommended to re-build each time, in case changes were made.

# Stop store
docker compose down

# View logs
docker compose logs -f app