First-run setup & the admin account
Getting started
First-run setup & the admin account
After installing VulaSocial, a few one-time steps get you logged in, branded, and ready to open the doors.
1. Open the site
Visit https://your-node.example/. You'll see the landing page with the
Create a free account button.
2. Create the first account
Registration is age-gated (18+):
- Age gate — confirm you're 18 or older.
- Register — name, email, password.
- Verify email — click the link in the verification email (requires SMTP; see Email / SMTP).
- Agreements — accept the node's legal agreements.
- Onboarding — set your handle and profile.
3. Make your account the admin
There are two ways:
Option A — promote via tinker (fast):
php artisan tinker
$user = App\Models\User::where('email', 'you@example.com')->first();
$user->forceFill(['pending_approval' => false, 'email_verified_at' => now()])->save();
Then assign the super_admin role. From the admin panel:
People & Access → Roles → give your user the super_admin role on the Default
team. (Or run the seeders in a dev/empty database.)
Option B — register then approve (approval-mode nodes):
If registration_mode is set to approval, new members are blocked until an
admin approves them. Register, then in the admin panel go to
People & Access → Users, find your pending account, and click Approve.
4. Set your branding
Go to Settings → Branding and set:
- Site name — shown in the header and admin brand
- Logo / Favicon / Hero image — see Branding
- Hero headline & subtext — the landing page message
- Colours — primary / secondary / link
5. Decide who can join
In Settings → Site Settings, set the registration mode:
Open— anyone can registerApproval— new members must be approved by an adminInvite only— requires an invitation token
See Registration modes.
6. Federation & media
- Federation — Settings → Federation.
Localworks out of the box; switch to FediFuel if you plan to offload. See Federation. - Media storage — Settings → Media Storage.
Localis fine to start; move to S3/Filebase when you need scale. See Media storage.
7. Confirm the admin area works
Log in at https://your-node.example/admin, then check:
- The dashboard shows your site's stats and charts
- People & Access → Users lists accounts
- Settings pages save without errors
Troubleshooting
- Can't log into
/admin? You need thesuper_adminrole (or an allowlisted admin email inconfig/app.php→admin_emails). - Verification email never arrives? SMTP isn't configured — see Email / SMTP.
- Blank page after install? Check
vendor/exists,.envhas anAPP_KEY, andstorage/+bootstrap/cache/are writable.
Still stuck? Contact the node administrator.