Installation guide

Hardware requirements

A blank full virtual machine or a bare metal server with:

• Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS
• A minimum of 2GB RAM and 20GB storage
• x86_64/amd64 or arm architecture

Interactive mode installation

You can install BeAdmin Control Panel from terminal in intercative mode. In this case system will ask you to enter email of your default user, and optionally the domain name of your server (to make it accessible via e.g. https://mysite.com:8080). An SSL certificate will be issued automatically in this case.

1. Log in to your server via SSH:

• as root or
• as a user with sudo privileges and type sudo -i

How to connect via SSH?

Typically, your hosting provider will provide connection details on the server management page (a command in the format ssh root@ip_address). Next, open the terminal or console on your local computer and run the command to connect.

For more details, see How to connect to a server via SSH?

2. Copy and paste the following installation command into the terminal and hit Enter:

wget  -O /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg "https://nexus.beadmin.com/repository/public-keys/beadmin-nexus-public.gpg"
chmod 644 /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg] https://nexus.beadmin.com/repository/beadmin/ stable main" > /etc/apt/sources.list.d/beadmin.list && \
apt update && apt install -y --no-install-recommends beadmin && \
systemctl enable --now beadmin

This will trigger the installation process, which can last about 15-30 secons or less. Your system will install the necessary packages using the apt package manager.

3. Follow the installation instructions

Next you may enter your server domain name if you already have one, e.g. mysite.com. In this case an SSL certificate will be issued after installation to make your server accessible via HTTPS. Leave blanc if you don have a domain name yet, in this case no certificate is issued.

💡 Tip

Do not forget to create a DNS record of A type pointing to your server IP address in the dashboard of your web hosting provider. Otherwise the server won't be accessible by your domain name.

Next you will be prompted to enter you main user email as login. Do it or leave default admin@local.host and hit Enter.

⚠️ Warning

Always enter a valid email address. If you entered a domain name on the previous step, the SSL generation will fail if the email address is invalid, and self-signed SSL certificate will be issued. You server will still be accessible via HTTPS, but most browser will rise a warning.

Hit Enter and wait until the installation is finished. After that you can go to BeAdmin by https://your_server_ip:8080 or https://your_domain:8080. Enjoy!

ℹ️ Info

If you didn’t specify a domain or are connecting directly to the server by IP address, your browser may display a warning Your connection is not private. This happens because the SSL certificate is self-signed and the browser cannot verify its authenticity.

Click Advanced, then Proceed to server_ip (unsafe).

Non-interactive mode installation

This option is best if you want a one-click installation or you are a web hosting provider and need a fully automated setup.

1. Log in to your server via SSH:

• as root or
• as a user with sudo privileges and type sudo -i

2. Prepare the installation command:

Replace mysite.com on the first optional line with a valid domain name of your choice. SSL will be issued automatically. Or delete this line if you do not want to add a domain name (you can do it later from the BeAdmin Panel).

Replace admin@local.host and your_password on the second optional lines with the email of your main admin user and his/her password. Always use a valid email, especially if you enter domain name on the previous line, otherwise a self-signed SSL certificate will be issued. Remove the line or leave as it is if you are good with admin@local.host.

wget  -O /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg "https://nexus.beadmin.com/repository/public-keys/beadmin-nexus-public.gpg"
chmod 644 /etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/beadmin-nexus-public.gpg] https://nexus.beadmin.com/repository/beadmin/ stable main" > /etc/apt/sources.list.d/beadmin.list && \

# (optional line)
echo "beadmin beadmin/ssl_acme_domain string mysite.com" | debconf-set-selections && \
# (optional lines)
echo "beadmin beadmin/default_user string admin@local.host" | debconf-set-selections && \
echo "beadmin beadmin/default_password password your_password" | debconf-set-selections && \

apt update && DEBIAN_FRONTEND=noninteractive apt install -y --no-install-recommends beadmin && \

systemctl enable --now beadmin

3. Copy-paste the command to the terminal and hit Enter.

The installation usually takes about a minute. Once done, you can go to BeAdmin by https://your_server_ip:8080 or https://your_domain:8080. Enjoy!