Support
Task-based guides for setting up BaseBuddy, connecting a content database, creating projects, mapping content, inviting users, fixing permissions, and operating BaseBuddy safely.
Common support tasks
Fix the usual blockers first.
How to connect your content database to BaseBuddyAdd the Postgres URL and optional Supabase storage credentials BaseBuddy needs before setup checks or mapping content.How to find your Supabase project URL and API keysFind optional Supabase storage values for BaseBuddy mapped media and file fields.How to set up BaseBuddy from UI or CLICreate BaseBuddy app data with onboarding or the BaseBuddy CLI.How to verify BaseBuddy sign-in setupConfirm local password sign-in, invite return paths, and safe redirects for a BaseBuddy install.How to create local password sign-in usersAdd BaseBuddy users to app data and verify password sign-in.How to map a posts tableMap your main posts table first, save the mapping, and verify the posts list and editor before adding related content.How to safely edit your first postTest BaseBuddy editing with one harmless field before allowing regular production content changes.Permissions and roles: how BaseBuddy handles themUnderstand BaseBuddy roles, effective permissions, owner boundaries, and author-scoped access before changing project access.
All pages
Setup and Storage
Database env, local sign-in, media storage, database users, and failed checks.
How to connect your content database to BaseBuddyAdd the Postgres URL and optional Supabase storage credentials BaseBuddy needs before setup checks or mapping content.How to create a database user on SupabaseCreate a dedicated Postgres role for BaseBuddy, grant access to mapped content tables, and test the new database URL safely.How to find or reset your Supabase database passwordFind where the Supabase database password is used, reset it when needed, update BaseBuddy, and verify the new database URL.How to find your Supabase project URL and API keysFind optional Supabase storage values for BaseBuddy mapped media and file fields.How to set up BaseBuddy from UI or CLICreate BaseBuddy app data with onboarding or the BaseBuddy CLI.How to verify BaseBuddy sign-in setupConfirm local password sign-in, invite return paths, and safe redirects for a BaseBuddy install.How to fix failed setup checksUse BaseBuddy diagnostics to find the first failing config, owner, auth, content database, or storage check.How to create local password sign-in usersAdd BaseBuddy users to app data and verify password sign-in.Google sign-in is not supported yetUnderstand why current BaseBuddy installs use local password sign-in instead of Google OAuth.How to rotate exposed Supabase keys and database passwordsRotate leaked Supabase secret keys, legacy service-role keys, and database passwords, then update BaseBuddy env values and verify setup checks.
Projects
Create, rename, customize, onboard, and remove BaseBuddy projects.
How to onboard and get started with a BaseBuddy projectCreate your first project, save a small content mapping, verify one harmless edit, and invite users after the project is safe to use.How to create a BaseBuddy projectAdd a project workspace for one existing content schema, then continue to mapping without changing your content tables.How to change the name of a BaseBuddy projectRename a project safely without changing database schemas, tables, or mapped content.How to delete a BaseBuddy projectRemove a BaseBuddy project workspace without deleting mapped content tables, rows, columns, storage objects, or schemas.How to update the project website URLChange the external website URL saved on a BaseBuddy project without changing the project address, mapping, or database tables.
Mapping
Hands-on help for mapping posts, markdown, fields, relations, and read-only states.
How mapping works on BaseBuddyUnderstand how BaseBuddy turns your existing tables, fields, and relations into an editor without changing your schema.How to map a posts tableMap your main posts table first, save the mapping, and verify the posts list and editor before adding related content.How to map markdown content safelyMap markdown fields so BaseBuddy preserves the stored format instead of silently converting content.How to fix a field showing as read-onlyUnderstand why BaseBuddy marks fields read-only and when it is safe to update the mapping.How to map authors to posts on BaseBuddyConnect your existing author records to posts so BaseBuddy can show and save one author assignment per post.How to map categories on BaseBuddyConnect your existing category storage so categories appear in the post editor and the built-in Categories section.How to map tags on BaseBuddyMap the tag fields, arrays, or relation tables your existing schema already uses, then verify that tag saves only touch that storage.How to map SEO fields on BaseBuddyConnect meta title, meta description, focus keyword, and URL slug fields from your existing posts table to the BaseBuddy editor.How to map redirects on BaseBuddyMap old post paths or slugs to the redirect data field your app already uses, then verify BaseBuddy edits only that mapped data.How to remove or reset mapping safelyDisconnect one BaseBuddy mapping section or reset all mapping without deleting your existing database or storage content.
Editing and Publishing
Task guides for first edits, workflow buttons, and content safety checks.
How to safely edit your first postTest BaseBuddy editing with one harmless field before allowing regular production content changes.How to publish, unpublish, and archive contentTest BaseBuddy workflow actions against the status fields in your saved mapping.How to use the editor toolbarFormat content, add links, insert media/files, use Save safely, and run explicit workflow actions from the editor toolbar.How to use slash commandsInsert structure, links, images, and files from the post body with slash commands.How to use keyboard shortcutsUse supported post editor shortcuts for formatting, structure, Save, and navigation.How to insert images into a postAdd body images from the Media library and understand how that differs from the separate Featured Image field.How to insert files or downloads into a postInsert file links from the Files library into a post body and save only the dirty body changes.How to edit SEO title, description, slug, and focus keywordUpdate SEO title, meta description, URL slug, and focus keyword fields safely from the BaseBuddy editor.How to use SEO and readability checksUnderstand BaseBuddy editor checks without treating them as publishing controls or full SEO automation.How to preview content safelyUse browser-local preview snapshots to check saved content or unsaved changes without saving, publishing, or deploying.
Authors and Members
Invites, author setup, author scopes, and project member access.
Authors vs members: what is the difference?Understand the difference between content authors and BaseBuddy project members before setting up access.How to set up authors on BaseBuddyMap author records and connect them to posts so bylines and author-scoped permissions work correctly.How to invite users to your BaseBuddy projectCreate invite links, choose roles, add author scopes when needed, and manage pending invites.How to accept a BaseBuddy inviteOpen a BaseBuddy project invite, sign in with the invited email address, accept the invitation, and open the project.How to fix an invite opened with the wrong accountSwitch from the current signed-in account to the invited email so a BaseBuddy project invite can be accepted.How to remove a member from a projectRemove project access safely without deleting the user's account, content, authors, mapping, or database rows.How to assign author scope to a memberLimit a BaseBuddy member to selected mapped author records and choose whether they can publish for each author.
Media and Files
Supabase Storage, S3-compatible storage, image uploads, file uploads, folders, and broken asset fixes.
How to upload and manage images in the Media libraryUpload images, browse folders, search the Media library, and manage image files safely.How to organize images with foldersCreate, open, search, move, and delete folders in the Media library without changing post content by accident.How to move or delete images safelyMove or delete images in the Media library without accidentally breaking existing posts, featured images, or old URLs.How to upload and manage files in the Files libraryUpload, browse, search, open, and manage non-image files in a mapped BaseBuddy Files library.How to organize files with foldersCreate, open, search, move, and delete folders in the BaseBuddy Files library without changing post content.How to move or delete files safelyMove or delete files in the Files library without accidentally breaking existing post links, file fields, frontend code, or private delivery routes.How to configure Supabase Storage buckets for media and filesCreate Supabase Storage buckets for uploaded images and files, then map those buckets to BaseBuddy Media and Files.How to configure S3-compatible storage for media and filesAdd env-backed S3-compatible storage credentials, map Media and Files storage, and verify uploads safely.How to fix broken image or file URLsDiagnose broken images, failed downloads, expired signed URLs, moved files, deleted assets, mapping issues, and frontend path handling.
Permissions
Roles, effective access, owner boundaries, author-scoped permissions, and access troubleshooting.
Permissions and roles: how BaseBuddy handles themUnderstand BaseBuddy roles, effective permissions, owner boundaries, and author-scoped access before changing project access.How to customize permissions on BaseBuddyAdd a narrow permission allow or deny for a project member when the built-in role is close but not exact.How to give a user access to only their own postsUse author mapping, the Author role, and author scopes so a member can work only on posts assigned to their mapped author record.How to troubleshoot missing edit buttons or read-only screensCheck permissions, author scopes, mapping, storage shape, publish access, and setup state when BaseBuddy does not let you edit.How to check what a member can accessReview a BaseBuddy member's roles, author scopes, permission overrides, and real project access before or after changing permissions.
Sidebar And Settings
Project settings, post sidebar fields, project addresses, and profile settings.
How to customize your BaseBuddy sidebarUnderstand which BaseBuddy sidebar is fixed and which post sidebar fields you can customize.How to customize post sidebar fieldsShow, hide, group, reorder, and save the fields editors see beside an open post.How to restore default sidebar fieldsReturn the post details sidebar to BaseBuddy's default field layout and save it for your project.How to unlock and change a project addressChange the BaseBuddy project path after unlocking the Project address field, without changing the website URL, database URL, mapped schema, or content tables.How to update your profile settingsChange your BaseBuddy display name and avatar from Profile settings, and understand why your sign-in email is locked.
Deployment And Operations
Deploy, configure domains, upgrade, back up, verify, and debug a production install.
How to deploy BaseBuddy to a VPS with DockerRun BaseBuddy on a VPS with Docker scaffolding, persistent config storage, HTTPS proxying, setup checks, and safe verification.How to deploy BaseBuddy with DokployDeploy the public BaseBuddy app repo on Dokploy with app-data storage, build commands, port, domain, and setup checks.How to configure production setupSet up BaseBuddy app data, production secrets, content database connection, and verification checks.How to configure custom domains and SSLPoint a production HTTPS domain at BaseBuddy, check proxy headers, and verify local password sign-in before editors use it.How to upgrade BaseBuddy safelyUpgrade a self-hosted BaseBuddy install with app-data backups, build verification, setup checks, and rollback notes.How to back up before upgradesBack up BaseBuddy app data and the content database before changing versions, credentials, or deployment storage.How to run setup checks after deployment or upgradeVerify BaseBuddy app data, local auth, content database, and optional storage after deployments or upgrades.How to read BaseBuddy logs when something failsFind the right BaseBuddy server log, identify the failing layer, and collect a safe support bundle without exposing secrets.
Troubleshooting
Fix sign-in, setup, missing projects, loading, saving, uploads, access errors, and bug reports.
How to fix BaseBuddy sign-in return issuesTroubleshoot local password sign-in, invite return paths, stale callback links, and production app-data storage.How to fix BaseBuddy setup check errorsOpen setup diagnostics, repair BaseBuddy app data, and rerun checks safely.How to fix missing projects after sign-inClear project search, confirm the signed-in email, accept invites, and check membership when BaseBuddy sign-in works but projects do not appear.How to fix content not loading in a projectTroubleshoot a BaseBuddy project that opens but cannot load posts, mapped collections, or content from the saved mapping.How to fix failed Save or Update in the post editorRecover safely after a post Save or Update fails, keep your draft, and check sessions, permissions, mapping, setup, and logs in the right order.How to fix media or file upload failuresTroubleshoot missing upload controls, rejected files, size limits, storage mapping, credentials, CORS, and host request limits for Media and Files uploads.How to fix owner or admin permission errorsTroubleshoot permission-denied messages when owners or admins manage project settings, members, invites, permissions, mapping, or project deletion.How to report a BaseBuddy bug with safe screenshots and logsCollect a reproducible public bug report for BaseBuddy without exposing credentials, cookies, private content, signed URLs, or security details.