Skip to content

Installation

Log in to the server over SSH and run, as root:

Janela do terminal
curl -sSL https://depanel.bsncloud.com.br/install.sh | sudo sh

The installer asks for the panel’s domain and an email for Let’s Encrypt notices. Leave the domain blank to use the free address (<ip>.sslip.io).

  1. Installs Docker, if it is missing.
  2. Checks that ports 80 and 443 are free.
  3. Generates the panel’s secrets in /opt/depanel/.env.
  4. Downloads and starts the panel, the database (PostgreSQL), metrics and the daily backup.
  5. Installs the agent for this machine, which shows up in the panel as “This computer” (Este computador).
  6. Shows the panel’s address and the first access code.

To automate (cloud-init, scripts), pass everything on the command line:

Janela do terminal
curl -sSL https://depanel.bsncloud.com.br/install.sh | sudo sh -s -- \
--dominio panel.yourcompany.com --email you@yourcompany.com --sim
Option What it is for
--dominio <host> the panel’s address (without it: <public-ip>.sslip.io)
--email <e-mail> email for Let’s Encrypt notices
--pasta <caminho> where to install (default /opt/depanel)
--borda <cidr> there is a proxy in front that sends PROXY protocol (e.g. 203.0.113.10/32)
--imagem <imagem> use a different panel image
--imagem-arquivo <tar> load the image from a file (docker save), without downloading
--sim ask nothing (uses the defaults)
--casa test on your computer, with Docker only (see home mode)

The /opt/depanel/.env file has the DEPANEL_CHAVES_MESTRAS variable. It encrypts the passwords and tokens stored in the panel. Keep a copy in a safe place: without it, a restored backup cannot open those secrets.

Running the installer again updates the panel and keeps your configuration and data. For day-to-day updates, use the panel’s own button: see Update.