Create the admin user
The first time SimpleDeploy starts with no users in the database, it shows a setup wizard. You have two paths.
-
Make sure the service is running:
Terminal window sudo systemctl status simpledeploy -
Open the management URL in a browser:
https://manage.example.com/ -
The setup screen prompts for a username, password, and optional display name. Submit.
-
The first account is automatically
super_admin. You land on the dashboard, logged in.
On the server:
sudo simpledeploy users create \ --username admin \ --password 'CHANGE_ME_LONG_PASSWORD' \ --role super_adminThen log in at https://manage.example.com/.
Strong passwords, please
Section titled “Strong passwords, please”- 16+ characters, mix of words and symbols.
- Use a password manager. Do not memorize.
- Rotate the password if you ever paste it into a chat or screen-share.
Issue an API key
Section titled “Issue an API key”API keys are how the CLI and CI systems authenticate. They look like sd_<random>.
sudo simpledeploy apikey create --name "laptop" --user-id 1# prints the key once. Save it.Or in the dashboard: Profile → API Keys → Create.
Roles at a glance
Section titled “Roles at a glance”| Role | Can |
|---|---|
super_admin | Everything: users, system, all apps |
admin | All apps + most settings (no user management) |
user | Only the apps explicitly granted to them |
Per-app access for user accounts is set under Users → (user) → App access. See Roles and permissions.