Just Dashboard First sign-in
Sign in as the first administrator, choose what the server is for, and set up account recovery.
After installing Just Dashboard 0.8.4, open the URL printed by install.sh. Sign in with the administrator username and password you entered or that the installer printed. The first account has the admin role.
Sign in
Enter your Username and Password, then choose Continue. If the account has more steps, the card shows them as Step 1 of 2 and so on, and lists only the steps this account actually has:
| If you see… | Do this |
|---|---|
| Two-factor code | Enter the six-digit code from the authenticator you enrolled and choose Verify. If you don't have it, choose Use a recovery code instead. Start over returns to the first step. |
| Set up two-factor | This appears when the installation requires an authenticator for every account. Choose Generate a secret, add it to your authenticator app, enter the Code from your app, and choose Enable two-factor. Then save the recovery codes it shows and choose I have saved them. |
| Change your password | This appears when the backend generated a bootstrap password for a manual Compose install, or when an administrator gave the account a starting password. Choose a new one with at least 12 characters, mixing three of upper case, lower case, digits and symbols. You're signed straight back in with it. |
The guided installer writes the password you chose or accepted into .env as JD_BOOTSTRAP_PASSWORD. That password is not forced to change at first sign-in; you can change it under Account → Security. A password set from the server with scripts/reset-password.sh or scripts/create-user.sh isn't asked for again either. Two-factor is optional by default, but any account that enrols an authenticator must use its code at later sign-ins. An administrator can make enrolment mandatory under Settings → Configuration.
Forgot the password?
There is no email reset. Choose Forgot it? on the sign-in card to see the command to run, then run it from a shell on the server, in the dashboard's folder:
sudo ./scripts/reset-password.sh adminReplace admin with the account's username. The script asks for the new password twice without echoing it, and that is the password you sign in with. A reset keeps the account's two-factor enrolment and signs out its sessions and API keys.
Choose what the server is for
The first time a new account signs in, the dashboard asks What will you use this server for? before it opens. Pick any number of cards:
| Card | Sidebar sections it keeps |
|---|---|
| Ship apps | Deployments, Proxy & TLS |
| Run databases | Databases, Backups |
| Work on the server | Terminal, Files, Git, Excalidraw, Remote Desktop |
| Manage containers | Docker |
| Secure the server | Security |
| Route the network | Network. Marked Experimental: it works but is still being tested. |
The first five start selected. A card shows a count when the server already has something for it, such as existing projects or databases. Choose Continue to save your sidebar; the next screen, Your server is ready, draws the server wired to what you picked. Choose Go to dashboard to open the Overview. Show me everything skips the choice and hides nothing.
Overview, Monitoring and Settings are always in the sidebar, and Packages, System users and the Audit log come with every answer. Your choice is saved to your account, so it follows you to every browser. The question is asked once: answering or skipping ends it.
Hiding a section is not a permission. Links from other pages still open it, search still finds it, and your role still decides what you can do there. Change the answer under Account → Workspace, which has a switch for each section and Ask me again to return to the question. Accounts created before 0.7.3 are not asked and keep every section.
Keep a recovery path
Open Account → Security to enrol an authenticator if you did not do so during sign-in, change your password, and regenerate recovery codes. Each recovery code works once. Save them somewhere outside the server. If a user loses their authenticator and recovery codes, an administrator can choose Reset two-factor for that user under Account → Users.
Take a first look
The Overview opens on shortcuts to start something, such as New project, Add a database, New shell, New drawing, Browse files, Add a computer and Back up. Each shortcut appears only for a section you kept and your role allows. The page also shows the host's readings, your open shells beside the drawings edited last, and the databases beside every backup job. The Coverage list on Backups shows resources without a backup job, including the dashboard's own data. Back up JD_DATA_DIR and keep JD_MASTER_KEY separately: a restore needs both. The roles reference explains what later accounts can do.