1. Getting started πŸ‘‹πŸ½

Learn how fast it is to integrate Onboardbase! It only takes 5 minutes to read, and another 5 minutes to install on your machine.

5700

Welcome to Onboardbase!

At Onboardbase, we remove the need for env files, hardcoded secrets, and copy-pasted credentials to make your life as a developer much easier.

In this documentation, you’ll find everything you need to integrate our service into your development processes, regardless of your tech stack or preferred framework.

What is Onboardbase?

Onboardbase is an all-in-one SecretOps infrastructure for securing environment configs/secret credentials across all stages, from development to production. It's designed for modern dev teams with rapidly changing requirements in collaborative environments.

As you'll read in this doc, our CLI or SDK provides easy access to secrets from local development to production in every development stage. Our dashboard makes it easy for teams to centrally manage app configurations for any application or platform.

1. Start with the CLI

The Onboardbase CLI provides access to your secrets in every environment, from local development, CI/CD, staging, and production. It is a lightweight binary available for almost every operating system and package manager, including docker.

It takes less than 5 minutes to add Onboardbase to any project:

  1. Install the CLI
# Install
npm i -g @onboardbase/cli@latest
# Install
yarn global add @onboardbase/cli@latest
# Install
brew install onboardbase/brew/onboardbase

# Update
brew upgrade onboardbase
# Add onboardbase singing keys as trusted
wget -O - http://deb-apt.onboardbase.com/debian/onboardbase.gpg.key | sudo apt-key add -

# Add onboardbase to your local repository
sudo touch /etc/apt/sources.list.d/onboardbase.list
echo 'deb http://deb-apt.onboardbase.com/debian/ obb main' | sudo tee -a /etc/apt/sources.list.d/onboardbase.list

# Update the source list
apt-get upgrade onboardbase

# Install Onboardbase 
apt-get -y install onboardbase

# Version
onboardbase -version
# Download the .deb file.
sudo wget https://onboardbase-cli.fra1.digitaloceanspaces.com/apt/onboardbase.deb


# Give the .deb file executable permission
sudo chmod +x onboardbase.deb


# Install with dpkg tool
$ sudo dpkg -i ./onboardbase.deb
# From your terminal run:
(curl -Ls --tlsv1.2 --proto "=https" --retry 3 https://onboardbase-cli.fra1.digitaloceanspaces.com/install || wget -t 3 -qO- https://onboardbase-cli.fra1.digitaloceanspaces.com/install) | sh -s --
# Add Onboardbase's scoop repo
scoop bucket add onboardbase https://github.com/Onboardbase/scoop-onboardbase.git

# Install latest Onboardbase CLI
scoop install onboardbase

# Update
scoop upgrade onboardbase

For Windows, you can also use the installer option:

  1. Run the init command
  2. Run your project using Onboardbase's run command
  3. Invite teammates (optional)
  4. Verify installation

You can verify that your Onboardbase CLI was successfully installed by checking the version.

onboardbase --version

Now you are ready to set up for your local development πŸ™ŒπŸ½

2. Register on Onboardbase

To begin with, if you don't have an Onboardbase account, please create one here.

Enter your full name, organization name, and email address, then click Continue with Email. A confirmation mail will be sent to the email address. Click on the link to continue to Onboardbase dashboard.

1. Create your first project and environment

After creating an account and from the dashboard, click on New button at the left sidebar.

Enter the name and description of the project, select the Environment Variables for this process, then click on Create.

After the project has been created, a new form will appear to create your first secret. Enter the Key and Value for the secret, then click on the Save button.

2. Create environments

By default, a new project has a development environment, but a project can have different environment secrets, like staging and production. Onboardbase supports this multi-environment setup.

From a project page, click on the development environment dropdown, enter the name of the new environment in the popup that appears, and select an environment to use as a base for the new environment - the secret from this environment would be copied over to the new environment.

Great Job! Chief πŸ₯³

You have successfully created your first project and environment.

  • Have a look at our FAQ you might find your questions answered there.
  • Check out our Blog and watch tutorials on YouTube.
  • Join our Community for updates and share your thoughts.
  • Follow us on our social media ( Twitter, Linkedin )

What’s Next

How to run Onboardbase in your project: