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:
- 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:
-
Download the Light Store package from BuiltByBit
-
Extract the package:
unzip Light\ Store\ v*.*.zip cd Light\ Store\ v*.* -
Start the containers:
docker compose up -d --build -
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.ymlif needed. - For HTTP: Use
-
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