Light Docs
Alternative installation methods

Installing with Docker

Learn how to set up Light Store using Docker and docker-compose.

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

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, or ones with specific requirements for the webserver.

Installing Docker

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

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

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 Caddy or Nginx guides for setting up the domain + HTTPS for the store

    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