Overview
Starting with v1.8, Light Store comes bundled with a convinience install.sh script for installing the app.
At the time of the release, it only officially supports Ubuntu (but can theoretically be used on any Linux distribution that uses the Debian-derived apt-get utility.)
The script offers a Docker setup with optional Caddy to route your domain and provide SSL certificates.
Prerequisites
To install this store, you need:
- a Ubuntu server (VPS, dedicated server, etc.),
- a domain name (or subdomain) with access to DNS.
Webserver Notice
The script currently only offers Caddy as the webserver. Caddy - aside from routing your domain - also provides automatic SSL certificate (re-)generation simplifying the HTTPS setup.
More options, like Nginx will be explored for this script in the near future, but for now, installing using Docker + setting up your own webserver is recommended.
Installation
Clean Server
This script is intended for clean servers with no Docker installed and no webserver. If ports 80/443 are taken, the webserver installation will be skipped and manual modification will be required. You may choose to use Docker & set up your webserver manually which is the recommended way prior to v1.8.
- Using an SFTP client upload the store .zip downloaded from BuiltByBit to any directory of your choice. We recommend
/var/www/store, but it can also be the home directory of your user (~).
TIP
To connect via SFTP, you can use WinSCP or FileZilla.
Enter the SSH shell (by running
ssh <your server's ip>in your system's terminal) and navigate to the directory where you uploaded the store - for example:cd /var/www/store.Unzip the store:
unzip "Light Store v1.8.0.zip"(your file name may differ depending on the version.)Run the script with the following command:
bash install.sh.
TIP
You might be prompted to enter your sudo password (for things like Docker or Caddy installation). If so, provide it.
- Follow the instructions on the screen.
Webserver included
After following the steps, a reverse proxy is automatically set up for you with automatic SSL for HTTPS. You do not have to manually link the domain as shown in the dedicated webserver guides.