Onboarding Wizard
Complete post-install setup via onboarding wizard: reset admin password, activate license, set base URL, configure repositories.
The JFrog Platform onboarding wizard launches automatically on first login and guides you through the minimum configuration required to start using the platform: admin password reset, license activation, base URL, optional proxy, and default repository selection. The wizard adapts to your deployment — for example, if JFrog Xray is installed, an additional step prompts you to select repositories for indexing.
If you add a new service to an existing JFrog Platform installation, the wizard reappears to guide you through configuring that service. The wizard does not re-launch after the first login is complete; use the Administration module for subsequent changes.
Prerequisites
The onboarding wizard is available in all JFrog Platform self-managed installations. Before you begin, verify the following.
- JFrog Platform installed and running: The onboarding wizard launches on first login. Verify the platform service is up before proceeding.
- Default admin credentials: The default login is username
admin, passwordpassword. You will reset this in step 2. - License key or bucket credentials: Have your JFrog license key ready to paste, or your license bucket name, key, and signed URL (for Enterprise+ installations with JFrog Mission Control).
Complete the Onboarding Wizard
Verify the Setup
Confirm that the onboarding wizard completed successfully:
Troubleshoot Onboarding Wizard Issues
| Symptom | Cause | Fix |
|---|---|---|
| Onboarding wizard does not launch on first login | Browser cache or existing session is stale | Clear browser cookies and cache, then navigate to http://<hostname>:8082/ui. If the wizard was already completed, access the same settings via the Administration module. |
| License key is not accepted in step 3 | Key is invalid, expired, or pasted with extra whitespace | Copy the license key directly from your JFrog account portal. Paste it without surrounding spaces and verify you have selected the correct license type (Full License vs. Xray Trial). |
| Base URL validation fails in step 4 | Hostname is not resolvable or the URL format is incorrect | Use the full URL including the protocol: https://artifactory.example.com. Ensure the hostname resolves from the browser's network. See General System Settings. |
| Cannot advance past step 2 | New password does not meet complexity requirements | Use a password of at least eight characters that includes uppercase, lowercase, and a number. |
Related Topics
- Getting Started
- Install JFrog Platform via Helm [Quick Start]
- Set TLS on the JFrog Platform
- Installing Artifactory
- System Requirements
Frequently Asked Questions
This section provides answers to frequently asked questions.
FAQs
Q: Can I re-run the onboarding wizard after completing it?
A: The onboarding wizard runs automatically on first login. After completion, you can access the same configuration options through the Administration module in the JFrog Platform UI. The wizard does not re-launch on subsequent logins.
Q: What happens if I skip a step in the onboarding wizard?
A: Optional steps (such as proxy configuration) can be skipped. Skipped steps do not block you from completing the wizard. You can configure skipped items later through the Administration module.
Q: Which license types are supported during onboarding?
A: The onboarding wizard supports both full license key activation and License Bucket activation. License Bucket activation is recommended for Enterprise+ installations with Mission Control enabled. For Xray Trial licenses, select the Xray Trial License option before entering the license key.
Updated about 2 months ago