Loading the documentation…

Install DataMind OS

This page takes you from an empty Linux server to a running DataMind OS in five steps. Every detail behind them is on Install in depth.

You need:

1. Get your License Key

  1. Sign in to platform.datamind.ai and open Instances.
  2. Click Add instance, enter a Name, such as Production, and click Add instance.
  3. Copy the License Key and keep it somewhere safe. It is shown only once. Click Done.

If DataMind sent you a License Key, skip this step. If you do not see Add instance, ask an Administrator of your company to add the instance for you.

If Instances already lists an instance that is not installed yet (Installed shows Not yet), for example one DataMind created for you, use it instead of adding a new one. If you do not have its key, open the row's Instance actions menu and click Regenerate key: Regenerate a key.

2. Run the install command

  1. On the server, run:

    bash
    curl -fsSL https://platform.datamind.ai/install.sh -o install.sh && sh install.sh
  2. When it asks DataMind License Key:, paste your key and press Enter. Nothing appears as you paste. That is normal.

  3. If it asks for a password, enter your own password for the server.

3. Answer two questions

The command checks your server first and changes nothing until you agree. The right answer is already selected each time, so press Enter.

  1. At Install the DataMind Installer now?, keep Install.
  2. At Use these ranges?, keep Accept.

When it finishes, it shows The DataMind Installer is running. and an address such as http://20.71.4.9:8000. If your server already uses Docker, you may see other questions; Install in depth explains them.

4. Finish the setup in your browser

  1. Open the address from step 3 in your browser.
  2. Under Create admin account, enter your email and a password, and click Create account.
  3. Click Start, then First-time install.
  4. Choose how people will open DataMind OS:
    • HTTPS, if you have a domain name and its certificate files. Enter the Domain, upload the Certificate file, with the chain and the Private key file, click Next, then Finish.
    • HTTP, otherwise. Check the Server address and click Finish.
  5. Click Start Installation, then Start Installation again to confirm.

The Installer downloads and starts every part of DataMind OS. Wait until it is done.

5. Open DataMind OS

Open the address you chose in step 4, and create your first DataMind OS administrator or sign in: First sign-in to DataMind OS.

Questions, answered

Do I have to install Docker first?

No. The install command installs Docker when the server does not have it, and uses it when it does. If you install without the install command, install Docker first: Install Docker yourself.

Should I choose HTTPS or HTTP?

Choose HTTPS when people will open DataMind OS at a domain name, such as datamind.example.com, and you have its certificate: the connection is encrypted. Without a domain or a certificate yet, choose HTTP and open DataMind OS at the server's address. You can add a certificate later: TLS and certificates.

The Installer page does not open in my browser. What do I do?

Your computer cannot reach port 8000 on the server. Ask whoever manages the server's firewall to allow port 8000 from your own address only, or open the page through an SSH tunnel: Install in depth.

Can I close the browser while the installation runs?

Yes. The installation runs on the server, not in your browser tab, and it keeps going. When you open the Installer again, it picks the running job back up and shows its progress.

What does the install command change on my server?

Nothing until you choose Install. Then it installs Docker if it is missing, gives Docker its address ranges, and starts the DataMind Installer, which runs DataMind OS. Every change is listed on Install in depth.