Skip to content

Create the admin user

The first time SimpleDeploy starts with no users in the database, it shows a setup wizard. You have two paths.

  1. Make sure the service is running:

    Terminal window
    sudo systemctl status simpledeploy
  2. Open the management URL in a browser:

    https://manage.example.com/
  3. The setup screen prompts for a username, password, and optional display name. Submit.

  4. The first account is automatically super_admin. You land on the dashboard, logged in.

  • 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.

API keys are how the CLI and CI systems authenticate. They look like sd_<random>.

Terminal window
sudo simpledeploy apikey create --name "laptop" --user-id 1
# prints the key once. Save it.

Or in the dashboard: Profile → API Keys → Create.

RoleCan
super_adminEverything: users, system, all apps
adminAll apps + most settings (no user management)
userOnly the apps explicitly granted to them

Per-app access for user accounts is set under Users → (user) → App access. See Roles and permissions.

Next: write your first compose file.