Skip to content

Installation

This guide will walk you through installing indobase on your server using Docker. indobase is designed to run on any operating system that supports Docker.

System requirements

Before installing indobase, ensure your system meets these minimum requirements:

  • 2 CPU cores
  • 4GB of RAM
  • 2GB of swap memory
  • Operating system that supports Docker
  • Docker Compose Version 2

Install with Docker

The easiest way to install indobase is using our Docker installer tool. This automated installer will guide you through the setup process.

Before running the installation command, ensure you have Docker CLI installed on your host machine.

Installation prompts

During setup, you'll be prompted to configure:

  1. HTTP and HTTPS ports - Your indobase instance's HTTP and HTTPS ports.
  2. Secret key - Your indobase instance's secret key used to encrypt sensitive data.
  3. Main hostname - Your indobase instance's main hostname. indobase will generate a certificate using this hostname.
  4. DNS A record hostname - Usually the same as your main hostname.

Installation commands

Manual installation

For advanced users who prefer manual setup, you can install indobase using Docker Compose directly.

Download configuration files

Download the required configuration files:

  1. Download docker-compose.yml
  2. Download .env
  3. Create a directory named indobase and move both files inside

Configure environment

Edit the .env file to customize your installation:

  • Update environment variables as needed
  • Set your desired configuration options
  • Ensure all required values are properly set

Start indobase

Once configured, start your indobase stack:

Bash
docker compose up -d --remove-orphans

Post-installation

After installation completes:

  1. Access the Console - Navigate to your machine's hostname or IP address in your browser
  2. Create an account - Sign up for your indobase account
  3. Create your first project - Set up your development environment
Startup time

On non-Linux hosts, the server might take a few minutes to start after installation completes. This is normal behavior.

Managing your installation

Stop indobase

To stop your indobase containers:

Bash
docker compose stop

Restart indobase

To restart your indobase containers:

Bash
docker compose start

Uninstall indobase

To completely remove indobase and all its data:

Bash
docker compose down -v
Data loss warning

The uninstall command will permanently delete all your indobase data. Make sure to backup any important information before running this command.

Next steps

After successfully installing indobase, you can:

Deploy on cloud platforms - Learn how to deploy on AWS, DigitalOcean, and other cloud providers

Configure services - Set up email, SMS, storage, and other services

Production setup - Prepare your installation for production use

Update indobase - Keep your installation up to date