Getting Started
Create your SecretStash account and complete the onboarding wizard to set up your first organization, application, and API token.
When you first sign into SecretStash, a guided onboarding wizard walks you through the essential setup steps. This ensures you have everything you need to start managing your environment variables right away.
Prerequisites
- A SecretStash account at secretstash.cloud
To create an account, visit secretstash.cloud and click Sign In or Start Free Trial. You can sign in with your email or continue with GitHub.
Onboarding Steps
Welcome
After signing in for the first time, you'll be greeted with a welcome screen that outlines the three core setup tasks:
- Create an Organization
- Create your first Application
- Generate an API Token
Click Get Started to begin.
Create an Organization
Enter a name for your organization (e.g., "Acme Inc" or "My Company"). Organizations are the top-level container that groups your applications and team members together.
You can create additional organizations later from the Organizations page.
Create an Application
Enter a name for your first application (e.g., "Customer Portal" or "API Backend"). Applications contain environments (development, staging, production) where your variables are stored.
A default environment is automatically created for each new application.
Generate an API Token
Provide a name for your API token (e.g., "CLI Token"). This token is used by the SecretStash CLI to authenticate with the API.
Your API token is only displayed once. Copy it immediately and store it in a secure location. If you lose it, you will need to create a new one.
Complete Setup
After generating your token, you will see a summary with your next steps:
- Install the SecretStash CLI package in your project.
- Add your API token and Application ID to your
.envfile. - Pull variables using the CLI:
- Laravel:
php artisan secret-stash:variables pull - Standalone:
vendor/bin/secret-stash secret-stash:variables pull
- Laravel:
Click Go to Dashboard to finish onboarding and access the main dashboard.
Next Steps
- Explore your Dashboard to manage applications.
- Learn how to manage Applications and their environments.
- Set up the CLI by following the Installation guide.