Installation guide
Install be-BOP in minutes
Our single-command installer handles dependencies, database setup, and SSL certificates automatically on your VPS.
System Requirements
Debian 12 or
Ubuntu LTS
1 GB RAM (2 GB rec.)
40 GB SSD Storage
example.com &
s3.example.com
Only used to generate
TLS certificates
Edit this command
Run this on your server — don't forget to replace the domain name and email address with your own:
curl -sfSL "https://be-bop.io/wizard/install.sh" -o
be-bop-wizard.sh && bash ./be-bop-wizard.sh -- --domain
"domain.com" --email "email@email.com"
Note: run this command as a user with sudo privileges, not as root.
Detailed Setup Guide
Server Access
Ensure you have SSH access to a VPS running one of the supported operating systems listed above, meeting the minimum hardware requirements. Any hosting provider works fine as long as those conditions are met.
For security reasons, avoid running the installer as root. Use a regular user account that has sudo permissions instead.
Domain Name
Register the domain name your customers will use to reach your be-BOP store. You can use a root domain (e.g. example.com) or a subdomain (e.g. shop.example.com).
You will point its DNS records to your server in the next step.
DNS Records
In your DNS provider's dashboard, create the following A records (IPv4):
chosen-hostname → A → your-server-ipv4 s3.chosen-hostname → A → your-server-ipv4
If your server also has an IPv6 address, add matching AAAA records:
chosen-hostname → AAAA → your-server-ipv6 s3.chosen-hostname → AAAA → your-server-ipv6
Leave the TTL at its default value. DNS propagates instantly for brand-new domains and typically within a few minutes for existing ones.
Run the Installer
Once you have SSH access to your VPS and your DNS records are correctly configured, copy the command above, replace mydomain.com with your chosen hostname and email@address.com with a valid address, then paste it into your terminal.
This email address is used exclusively by Let's Encrypt to issue your TLS certificates — it is never transmitted to or stored by the be-BOP team.
Initial Configuration
Once the installer finishes successfully — usually within 2–5 minutes — open your domain in a web browser, create your super-admin credentials, and start configuring your be-BOP to your liking.
The video tutorials linked at the top of this page and the official be-BOP documentation are great starting points if you need guidance.
Troubleshooting & Help
Troubleshooting
Stuck during installation? The wizard displays actionable error messages to help you identify the issue. First, verify that you meet the system requirements and that your DNS records are correctly configured.
If the problem persists, check the open issues on our installer repository and open a new one if none address your situation.
Where to get help
Reach out on the platform where you're most comfortable, we're active across several of them.