Welcome to PocketHost! This guide will help you set up your first PocketBase instance and get you familiar with the basics of our platform. Let’s dive in!
1. Create a PocketHost Account
The first step is to pick a plan and pay. Your account is created from your payment.
Pick a plan: Visit pockethost.io/pricing and choose a plan. Checkout opens right there.
Set up your account: After you pay, choose the email you want to sign in with and a password. We fill in the email you paid with, and you can change it. We also email a setup link to the email you paid with, so you can finish later or from another device. Already have an account? Log in on that same page to add the purchase to it.
Create your first instance: You land on your dashboard. Click Create your first instance.
Email Verification: Click the link in the confirmation email. You can’t use instances until your email is verified. Unverified accounts and their instances are deleted after 7 days.
Changing your email: Go to Account → Change email, enter the new address, and confirm from the new inbox with your current password. Your old email stays active until you confirm.
2. Choose an Instance Name
After logging in, you can create a new PocketBase instance.
Auto-Assigned Name: If you prefer, you can let PocketHost assign a random, unique name to your instance.
Custom Name: You can also choose a custom name that reflects your project or brand.
Note: Instance names must be unique and comply with our naming guidelines.
3. Accessing the Instance Admin Interface
Once your instance is created, you can access the PocketBase admin UI.
Admin URL: Navigate to https://<instance>.pockethost.io/_
Replace <instance> with your instance name.
Login: Use the default admin credentials provided during instance creation.
Example:
https://myapp.pockethost.io/_
4. Exploring the Instance Dashboard
PocketHost provides a user-friendly dashboard to manage your instances.
Dashboard Access: Log in to your PocketHost account and go to the Dashboard.
Instance Management: From the dashboard, you can:
Start, stop, or restart instances.
View instance status and resource usage.
Configure settings and access logs.
5. Managing instance files
Use the PocketHost CLI for hooks, migrations, static files, and backups:
npm install -g pockethost
pockethost login
pockethost link my-instance
pockethost dev
pockethost dev deploys your project as you save. pockethost files, pull, upload and rm handle everything else, including pb_data. See Files.