Install be-BOP in minutes

Run a single command on your server and the installer will do the rest. When it finishes, be-BOP will be ready for initial configuration.

Requirements

  • A Linux machine running Debian or Ubuntu LTS. Minimum: 2 GB RAM, 40 GB disk, internet access.
  • A domain name you control. Example: example.com
    You will need two DNS records pointing to your server: 
    example.com      → A / AAAA → your server IP
s3.example.com   → A / AAAA → your server IP
  • An email address used only for Let's Encrypt TLS certificates.

How do I get this?

Edit this install command

Run this on your server(don't forget to change the domain name and email-address):

bash <(curl -fsSL https://be-bop.io/wizard/install.sh) --domain "mydomain.com" --email "email@address.com"

Prefer to review first? Read the script here before running it. The script will display all planned tasks and ask for confirmation before making changes.

Installation typically completes in 3–10 minutes, depending on network speed and package updates.

After installation

Visit your domain in a browser. be-BOP will be ready for initial configuration via the web interface.

How to get what you need (domains, servers, DNS)

1) Get access to a server

You'll need access to a server where you can run commands. This can be a virtual private server (VPS) from any hosting provider, a dedicated machine, or even a spare machine at home running Linux, as long as it meets the requirements and has a public IP address reachable from the internet.

Once your server is ready, make sure you can connect to it:

  • Via SSH (using your terminal or an SSH client), or
  • Through your provider's web console, if they offer one.

To confirm that you have shell access, try running a simple command like: 

date

If it prints the current date and time, you’re in the right place.

You don’t need to choose a specific provider — any that give you control over a Debian or Ubuntu LTS environment with a minimum of 2 GB RAM, 40 GB disk, and internet access will work fine.

2) Get a domain name

Register a domain with any provider you prefer. You may use your root domain (e.g. example.com) or a subdomain (e.g. shop.example.com).

You will set up DNS for it in the next step.

3) Point DNS to your server

Configure DNS so that your chosen hostname and its companion s3. subdomain both resolve to your server:

  • Create A records (IPv4) 
    chosen-hostname       → A → your server IPv4
s3.chosen-hostname    → A → your server IPv4
    You can usually find this setting in your domain registrar or DNS provider's dashboard, often under sections called “DNS Management” or “Zone Editor.” The IPv4 address is a series of four numbers separated by dots, like 203.0.113.42.
  • If your server has IPv6, create AAAA records 
    chosen-hostname       → AAAA → your server IPv6
s3.chosen-hostname    → AAAA → your server IPv6
    An IPv6 address looks different — for example, 2001:db8::1234. If your provider doesn’t list an IPv6 address for your server, you can safely skip this step.
  • TTL can be left at the default (e.g. 300–3600 seconds).
  • Wait for DNS to propagate (usually instantaneous for new domains; otherwise may take a few minutes, per the existing TTL).

4) Ready for takeoff

  • Once you have access to your server (see the “Get access to a server” section above), copy the installation command from this page, paste it into the terminal, and press Enter (or Return) to start the installation process.

5) Where and how to get help

If something doesn’t work as expected, don’t worry — we can help you troubleshoot. When reaching out, please include a few details so we can understand your setup quickly:

  • The hosting provider where your server is running.
  • The domain registrar you used for your DNS settings.
  • Your domain name and basic server specs (a screenshot of your VPS page usually shows this).
  • A screenshot of the error message and any visible output, or note if nothing appeared.

You can also include the full command output if you already ran the installation.

What the installer does
  1. Environment checks — verifies OS, CPU/RAM/disk, network reachability, and required ports.
  2. TLS certificates — obtains and installs HTTPS certificates from Let's Encrypt automatically.
  3. Deployment — fetches be-BOP components, sets up services, configures networking and persistence.
  4. Bring-up — starts the web interface. At this point, be-BOP is ready for initial configuration.
Security & transparency notes