Mirroristas/pockethost
2
0
Fork 0
mirror of https://github.com/pockethost/pockethost.git synced 2025-03-30 15:08:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

enh: rizzdown enhancements to documentation

Browse Source
This commit is contained in:
Ben Allfree 2023-10-05 16:09:12 -07:00
parent 4274bdba50
commit 01ebc69367
50 changed files with 866 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
packages/www/content/blog/0.0.1.md
View File

@ -1,9 +1,23 @@
---
title: PocketHost 0.0.1
description: A new version of PocketHost has been released.
date: 2022-09-18
date: 2022-09-18T00:00:00.000Z
description: Explore the alpha version of PocketHost 0.0.1, your one-click
solution for multi-tenant hosting of PocketBase projects. The system runs on a
single Digital Ocean VPS and Svelte front-end, with instant SSL certification
and dynamic port assignment. Discover this new level of simplicity and
efficiency in web development here!
---
# Overview
Unleash the alpha magic of PocketHost 0.0.1, an inventive, one-click solution that will transform how you host PocketBase projects. Let your creative web development juices flow as [pockethost.io](https://pockethost.io), our groundbreaking product, offers compact multi-tenant hosting handled by a single Digital Ocean VPS and a whip-smart Svelte front-end. No need to tackle SSL certification and dynamic port assignment - they’re instant and automatic here.
Marvel at how this lean, mean hosting machine operates. With pockethost.io, a keenly focused daemon runs on your VPS, always alert for new records from the primary pocketbase instance. Spotting one, it springs into action, provisioning an SSL cert, updating nginx, creating the data storage location, then locating a free port to give life to a new pocketbase instance solely committed to the new entry. Fear no crashes, everything automatically resurrects during startup. Keep a watchful eye on instance health, uptime, port number and more with an admin-only table.
Rejoice, as each pocketbase instance claims its own subdomain. PocketHost 0.0.1 is still evolving. Future releases will offer even more, such as the ability to preconfigure pocketbase instances and more dynamic email configurations. Your feedback and suggestions will help drive which direction we head next. Edison once said, "I find out what the world needs, then I proceed to invent it." Let's invent together. Join the journey now!
I have an alpha up at https://pockethost.io.
- Running on a single Digital Ocean VPS

21
packages/www/content/blog/0.2.0.md
View File

@ -1,9 +1,26 @@
---
title: PocketHost 0.2.0
description: A new version of PocketHost has been released.
date: 2022-10-12
date: 2022-10-12T00:00:00.000Z
description: >
PocketHost 0.2.0 has been released, featuring fully Dockerized services and
advanced scaling using a dynamic proxy. Experience smooth project launches
plus added server power, and future possibilities with fly.io integration. The
update promises more accessible back-ends and powerful BaaS with the coming
PBScript release and pockethost integration.
---
# Overview
Immerse yourself in the expansive world of PocketHost 0.2.0, the latest iteration of this user-friendly, fully-managed PocketBase hosting service. Rejoice in the full Dockerization of services for seamless project execution while basking in the glow of substantial, dynamic proxy-driven scaling.
Say goodbye to constant crashes due to memory constraints, as the dynamic proxy in v0.2.0 introduces just-in-time launching of your PocketBase instances. The period of inactivity now triggers the shutdown of an instance until the next request, ensuring cost-effective usage and optimal performance.
Think power. Picture an upgraded server delivering 4GB RAM and dual CPUs, thus creating abundant room for your creative indulgence. Imagine the potential with an upcoming fly.io integration, allowing on-demand spinning up of instances, leaving behind the era of shared tenancy.
Next, envision the convenience of an instant backend, complete with email and S3, brought to you by shared tenancy on pockethost.io. Imagine the synergistic power of the forthcoming PBScript release combined with pockethost integration for an unrivaled BaaS experience. Finally, expect a refreshed SvelteKit UI for pockethost, courtesy of @brewhousedigital, promising an aesthetic overhaul soon. To join the rocket ride of this evolution, explore https://github.com/benallfree/pockethost.
The fully managed PocketBase hosting service https://pockethost.io has been updated to v0.2.0. Go check it out and spin up your very own PocketBase instance 🚀
This release is [fully Dockerized](https://github.com/benallfree/pockethost/blob/master/docker/docker-compose.yaml).

18
packages/www/content/blog/0.3.0.md
View File

@ -1,9 +1,23 @@
---
title: PocketHost 0.3.0
description: A new version of PocketHost has been released.
date: 2022-10-26
date: 2022-10-26T00:00:00.000Z
description: Unleash the potential of PocketHost 0.3.0! This revolutionary
update introduces enhanced Docker and proxy support, enriched developer
documentation, and a complete UX redesign. Also, get the ability to run
varying PocketBase versions for custom use-cases, including beta/dev, with
visually striking running status indicators in vibrant green.
---
# Overview
Unveil the raw power of PocketHost 0.3.0! This game-changing upgrade has shifted the gears with amplified Docker and proxy support, expanded developer documentation, and a total UX overhaul. Now, you have the capacity to operate varying versions of PocketBase for bespoke scenarios, including beta/dev, decked with an eye-catching running status display in vibrant green.
Dive into the enhanced realtime support in the proxy, flawlessly turning around the shortcomings of the previous versions. The developer docs have been overhauled to encompass more comprehensive instructions and hands-on examples, shunning any unclear notions.
Experience Docker functioning at its superlative for both dev and production environments, as Docker support has received a significant improvement. Navigate through a completely redesigned user interface, engineered with simplicity and usability at its core.
Keep track of your PocketBase instance status with ease, as idle/running statuses now project in an unmissable shade of green. Push the envelope even further by spawning different versions of PocketBase per instance tailored to fit your custom use-cases, including beta/dev. With PocketHost 0.3.0, tapping into the immense potential of backend development has never been smoother or more efficient.
- Improved realtime support in proxy
- Updated developer docs
- Improved Docker support for dev and prod

19
packages/www/content/blog/0.3.1.md
View File

@ -1,8 +1,23 @@
---
title: PocketHost 0.3.1
description: A new version of PocketHost has been released.
date: 2022-10-26
date: 2022-10-26T00:00:00.000Z
description: Dive headfirst into PocketHost 0.3.1, rolled out this October with
exciting features! Experience seamless OpenGraph support, amplifying your
project visibility across browsers. Immerse yourself in vivid dark mode
enhancements, easing the strain on your eyes during those late-night coding
sessions. It’s like having coffee with Darth Vader in The Matrix - intense and
thrilling!
---
# Overview
Strap in, coder jockeys, let's blast off into the refreshing depths of PocketHost 0.3.1, rolled out this October, full throttle with features that will have your fingers itching to hit those keys. Eager to increase your project visibility across browsers? Make your mark with OpenGraph support, a game changer for managing how URLs display in social media. Expect more traffic, higher engagement, and a significantly enhanced user experience.
Now, let's switch gears to the most requested feature - enhanced dark mode. Coding late into the night? Save those retinas without compromising code quality, because now you can. Imagine pairing up with Darth Vader for a coffee catch-up in The Matrix. Sounds intense? That’s what we’re dishing up. The updated dark mode offers improved readability, reducing eye strain during those all-night coding marathons. It’s clean, focused and makes those long coding sessions a joy rather than a chore.
So next time you find yourself cursing under your breath at a stubborn piece of code late into the night, remember – PocketHost's got your six. OpenGraph and Dark Mode support are here to make your life easier and your users' experience better. Emerge victorious from those late-night battles with code; victorious and a little less strained. Happy coding!
- OpenGraph support
- Darkmode enhancements

23
packages/www/content/blog/0.3.2.md
View File

@ -1,8 +1,27 @@
---
title: PocketHost 0.3.2
description: A new version of PocketHost has been released.
date: 2022-10-26
date: 2022-10-26T00:00:00.000Z
description: Uncover the latest updates from PocketHost with version 0.3.2, a
cut above the rest that prioritizes security and efficiency. We've moved the
PBScript repository for streamlined access and ramped up security so accounts
must be verified before instance operation. A pivotal step for our NodeJS
developers.
---
# Overview
---
title: Unleashing PocketHost 0.3.2: A NodeJS Developer's New Best Friend
date: 2022-10-26T00:00:00.000Z
description: With PocketHost version 0.3.2, step into the empowering realm of amplified efficiency and bolstered security. Unearth the might of PBScript — now in a spruced up repository that champions ease of access. Raising the security bar a notch higher, accounts are now mandated to undergo verification before getting the green signal to operate an instance.
---
Embark on a transformative journey towards enhanced accessibility with the newly migrated PBScript repository. No more hide and seek to find it. Simple, straightforward, just the way a NodeJS wrangler prefers it. With this move, tap into the repository with fewer clicks and more success.
Security slid into our spotlight and decided to take center stage. PocketHost 0.3.2 is a fortress that only permits entrance after stringent account verification. Run an instance? Not until we know you're legit. This safety-first mantra of being 'verified before you're amplified' boosts security while fostering an environment that respects authenticity and protects your creative NodeJS endeavors. Exploit this pivotal notch-up and make your server-side applications impervious to malware henchmen, as you play the melody of efficient coding on the powerful strings of PocketHost. The force is with you, node-wranglers. Craft your masterpiece with PocketHost 0.3.2.
- Migrated PBScript repository to here
- Accounts must now be verified before running an instance

16
packages/www/content/blog/0.4.0.md
View File

@ -1,8 +1,20 @@
---
title: PocketHost 0.4.0
description: A new version of PocketHost has been released.
date: 2022-11-02
date: 2022-11-02T00:00:00.000Z
description: Unveiling the latest enhancement of pockethost.io with
PocketHost 0.4.0. Our update brings in full support for PocketBase 0.8
alongside the novel concept of 'platforms' for seamless version control. A
breakthrough for NodeJS developers seeking to streamline their project
workflow with our proficient backend solution.
---
# Overview
Take a seat, nod to the screen and prepare to dive into the world of PocketHost 0.4.0. Unveiling an update that is ripe with enhancements tailored to bolster your project workflows. This fresh layer of technology comes loaded with complete support for PocketBase 0.8 – propelling you closer to that 100% proficiency mark in backend solutions.
Entering stage right, we witness the introduction of the ingenious, 'platforms', a concept designed for seamless version control. An invaluable ally for NodeJS developers as they traverse the path of project streamlining. In the fickle world of version control, 'platforms' stand as the Han Solo to your Millennium Falcon, navigating the intricate passages within the abyss of coding with ease.
Rise, pocket that coffee-filled mug and embrace the robust infrastructure offered by pockethost.io’s latest update. Remember, progress in coding isn't measured by the sweat on your brow, but the smoothness and fluidity of your workflow. Step towards that coding nirvana by wielding this serendipitous update to your arsenal. Unleash the power of PocketHost 0.4.0 and make the coding galaxy your sandbox. No need to hold your breath, the force will always be with you.
- PocketBase 0.8 support
- Introduced "platforms" concept for version control

17
packages/www/content/blog/0.4.1.md
View File

@ -1,9 +1,22 @@
---
title: PocketHost 0.4.1
description: A new version of PocketHost has been released.
date: 2022-11-05
date: 2022-11-05T00:00:00.000Z
description: Unveiling PocketHost 0.4.1! Updated to support both 0.7.10 and
0.8.0-rc2, this version is freshly juiced with go 1.19.3 and brings you some
slick Docker build system updates. Dive in for an electrifying experience for
NodeJS developers ready to push their creations into the world!
---
# Overview
Entering the arena with a mighty roar, it's PocketHost 0.4.1 - primed and ready to unleash a wave of enhancements that will drive your node.js creations straight into the heart of the digital world. With support now extended across 0.7.10 and 0.8.0-rc2, this upgrade is standing on the shoulders of the coding giants, beckoning you to follow suit.
Peel back the curtains and you'll find the engine-room of PocketHost 0.4.1 is now fuelled by go 1.19.3. This latest iteration of the open source programming language designed for efficiency and reliability is powering up PocketHost, making it an even more formidable force in the cloud hosting space. Brace yourselves for an invigorating sprint filled with streamlined performance and precision that can put a Swiss watch to shame.
Dig a little deeper and the Docker build system will catch your attention, shuffling on its dancing shoes and spinning a whole new set of updated moves. The improvements to the Docker build system are like adding an extra gear to your interstellar hyperdrive. So, sit tight as PocketHost 0.4.1 takes you on a wild ride across the ever-growing landscape of cloud tech, letting you focus on what you love most - creating stuff that makes a difference. Let's take the leap together!
- Support for 0.7.10 and 0.8.0-rc2
- Update to go 1.19.3
- Docker build system updates

26
packages/www/content/blog/0.4.2.md
View File

@ -1,7 +1,29 @@
---
title: PocketHost 0.4.2
description: A new version of PocketHost has been released.
date: 2022-11-05
date: 2022-11-05T00:00:00.000Z
description: Unleash the potential of PocketHost with the latest 0.4.2 update.
Now, get real-time runtime metrics that display the usage of your instance in
terms of minutes per month, allowing enhanced project tracking and resource
management. Level-up your backend development and project efficiency with the
power of PocketHost.
---
# Overview
---
title: Explore the New Frontier with PocketHost 0.4.2!
date: 2022-11-05T00:00:00.000Z
description: A game-changer is here in the realm of backend development with PocketHost’s latest 0.4.2 update. Enter a higher dimension of project tracking and resource management with real-time runtime metrics that display your instance usage in minutes per month. Ride the wave of efficiency and potentiate your project performance with this dynamic new feature!
---
Unleash the full potential of your PocketHost instance, and let the numbers do the talking. With the 0.4.2 update, tap into an insightful dashboard that presents real-time runtime metrics offering by-the-minute insights on the usage of your PocketHost instance. Should you desire to render Time Lords redundant, imagine the immense power to manage and architect your ongoing and future projects, knowing exactly how many minutes per month your instances sail in the digital sea.
Less guesswork, more precision. Decode your projects’ performance with laser-sharp clarity, and take optimisation to never-before-seen levels. It's like gaining a mystical sixth sense for grasping the nuances of your backend developmental processes. Go ahead, give the 0.4.2 update a try and make backend development more of a strategic chess game than a showy firework display.
Bring it on future, we're armed with facts and stats – PocketHost’s latest 0.4.2 update. The next round of the node.js symphony is here for all you cloud orchestra directors out there. Amplify the rhythm of your backend development projects.
- Runtime metrics now show how many minutes per month an instance has used

18
packages/www/content/blog/0.5.0.md
View File

@ -1,9 +1,23 @@
---
title: PocketHost 0.5.0
description: A new version of PocketHost has been released.
date: 2022-11-10
date: 2022-11-10T00:00:00.000Z
description: Experience PocketHost 0.5.0 — your key to enhanced backend
development. Newly added features include data backups, version display, UX
improvements, and password reset capabilities. Now, easily view your
PocketBase instance version number right from the dashboard. It's high time to
change the game in backend hosting and deployment.
---
# Overview
Charge into the nexus of backend development with PocketHost 0.5.0! Bearing an armory of new features, it elevates your backend game to a new level. Like a Time Lord with backups, tap into the ability to create data backups. Never lose sight of your version with the version display feature implanted right next to the PocketHost logo.
Experience a wave of user interface refreshments. Enjoy an enhanced account activation process—a seamless experience reminiscent of a console's perfectly executed command. Further, forget fretting over forgotten passwords, as the password reset feature is here for your rescue.
Navigate with ease through an updated menu—may your journey be as smooth as a high-performing algorithm. The pièce de résistance is that your PocketBase instance version number is now displayed on the dashboard, a cue taken from your own coding principles.
With 0.5.0, PocketHost is staking its claim as more than just a backend hosting and deployment service. It's a doyen of developer tools ready to assist, inspire, and improve your code crafting process much like a faithful judo partner, always there to support yet ever challenging you to be better. It's time to fire up your terminals and experiment with the new gadgets in your tech arsenal.
- Create data backups
- Display version near PocketHost logo
- Account activation ux enhancements

21
packages/www/content/blog/0.5.1.md
View File

@ -1,8 +1,25 @@
---
title: PocketHost 0.5.1
description: A new version of PocketHost has been released.
date: 2022-11-16
date: 2022-11-16T00:00:00.000Z
description: We're continuing our journey towards perfection with PocketHost
0.5.1. This update rectifies a bug causing a 404 error post-instance creation
and resolves an issue with the SQLite3 build. As always, we're committed to
making PocketHost the go-to backend solution for all NodeJS developers.
---
# Overview
Title: Unveiling PocketHost 0.5.1
Date: 2022-11-16T00:00:00.000Z
Description: "Embrace the evolutionary improvements of PocketHost 0.5.1. This update zaps the annoying bug which spawned a 404 error post-instance creation, rendering it obsolete. More so, let's not forget the rectified issue with the SQLite3 build. PocketHost steadily and passionately paves the way to the podium of go-to backend solutions for the NodeJS developer community."
---
PocketHost 0.5.1, the latest iteration, cleans up its act by fixing two key issues that have bugged developers. The pesky problem of 404 error occurring right after creating an instance? Consider it history. The bugs didn't stand a chance against the tech surgeons behind PocketHost, dedicated to enabling uninterrupted backend operations for all web developers.
The SQLIte3 build gets a much-needed fix in this update as well. Do you remember those frustrating moments due to SQLite3 glitches? Worry no more. This update is the remedy for the SQLite3 hangover, making your journey with PocketHost more satisfying and efficient.
With PocketHost's devotion to perfection and resolve to be your first choice for backend solutions, this update signifies their unwavering commitment. Consider this a step further on our never-ending quest toward backend nirvana. Step into this new realm of seamless backend operations with PocketHost 0.5.1.
- fix: 404 after creating instance
- fix: SQLite3 build

27
packages/www/content/blog/0.5.2.md
View File

@ -1,9 +1,32 @@
---
title: PocketHost 0.5.2
description: A new version of PocketHost has been released.
date: 2022-11-19
date: 2022-11-19T00:00:00.000Z
description: Explore the latest updates to PocketHost v0.5.2 - our robust
hosted backend service for NodeJS developers. This release brings rc3, rc4,
and 0.8.0-final support, optimizes with yarn deduplication, enhances
Typescript bootstrapping, and fixes account verification through a
hard-redirect. Stay in the loop with PocketHost - the one-stop solution for
smooth deployments.
---
# Overview
---
title: PocketHost 0.5.2: Explore Your Expansive NodeHorizon
date: 2022-11-19T00:00:00.000Z
description: Scale new heights with the latest evolution of PocketHost v0.5.2. The stalwart backend service explicitly crafted for the NodeJS developer that dares to step beyond the ordinary. See what's within the Pandora's box of rc3, rc4, and 0.8.0-final support. Delve into yarn optimization with deduplication, unravel enhanced TypeScript bootstrapping, and tackle the account verification fix that packs a punch with a hard-redirect. Ready for the journey? Let's hit the road with PocketHost - your one-stop solution to seamless deployments!
---
Kicking off with the heavy-duty stuff, PocketHost v0.5.2 now embraces support for rc3, rc4, and 0.8.0-final. A powerful combo sure to satisfy even the most ambitious coders.
Next, let's talk optimisation. Yarn's reputation as a quick and secure dependency manager goes hand in hand with PocketHost's ethos. By introducing deduplication in this release, PocketHost has achieved the hitherto elusive feat of a leaner, more efficient build pipeline.
Typescript's static type-checking capacity adds a layer of reliability that JavaScript can't provide. Enhancing TypeScript bootstrapping, therefore, brings you the power of early error-detection while keeping improvements manageable between versions, ensuring faster, more efficient deployments.
Finally, the cherry on top - unraveling a longstanding fix. The account verification process now incorporates a hard-redirect, curing any associated validation hiccups. Be bulletproof, be trustworthy. Let the PocketHost 0.5.2 update make deployments a cinch, freeing you to focus on what truly matters - creating outstanding applications.
- chore: rc3, rc4, 0.8.0-final support
- chore: dedupe yarn
- Fix: Account verification needs to hard-redirect

23
packages/www/content/blog/0.5.3.md
View File

@ -1,9 +1,28 @@
---
title: PocketHost 0.5.3
description: A new version of PocketHost has been released.
date: 2022-11-21
date: 2022-11-21T00:00:00.000Z
description: Imbibe in the latest iteration of PocketHost 0.5.3! We've
retrofitted our backend to provide improved dashboard details, error messages
for backup discrepancies, and rejuvenated aut0-cancellation. Built on go
1.19.3, we've thrown in some slick refactoring manoeuvres for logging and
async operations. Plus, we've barricaded backups for missing data directories.
Enjoy!
---
# Overview
Brace yourselves for the sweet sting of progress as PocketHost 0.5.3 lands with gusto. Peep under the hood and you'll find a backend revamp geared for the future, built on the might of go 1.19.3. From polishing the dashboard details to fortifying the backup functionalities, this version comes ready to rock the stage.
Bid farewell to unhelpful, blank-stare inducing error messages. PocketHost 0.5.3 has been infused with an oracle-like ability to articulate clearly about backup discrepancies. Now, encountering a failed backup due to a non-existent instance won't feel like deciphering an alien language.
Experience the sheer joy of asynchronous operations streamlined for better performance and neat, courteous contextual logging. The version number has moved on like a nomad, finding a new home in the base package.json. Just when you thought auto-cancellation might have taken a sabbatical, guess what, it's back and hustling!
The backup feature in PocketHost has historically been more protective than a mother in a Kung Fu film. With 0.5.3, it now reinforces the defense by outright denying backups for missing data directories.
Essentially, it's not just a new iteration - it's a whole new animal. So, buckle up, code ninjas, and enjoy this smooth new ride in the world of PocketHost.
- fix: incorrect instance information displaying on dashboard details in some cases
- fix: more helpful error message when backup fails for nonexistent instance
- chore: move version number to base package.json

23
packages/www/content/blog/0.5.4.md
View File

@ -1,9 +1,28 @@
---
title: PocketHost 0.5.4
description: A new version of PocketHost has been released.
date: 2022-12-09
date: 2022-12-09T00:00:00.000Z
description: >
Discover the latest updates on PocketHost 0.5.4 in this insightful post.
Uncover essential fixes to the 'Create Instance' cancel button and the
instance activity status for real-time events, coupled with chores providing
support for PocketBase 0.9.0 and 0.9.1. Immerse in this technical tour that
adds finesse to your PocketHost experience.
---
# Overview
Buckle up and swiftly ride into the latest offerings from sunny PocketHost 0.5.4. Dive into the matrix as we unravel essential adjustments, bug fixes, and crucial backend compatibility upgrades. It's a wild journey on this Most Serene Republic of Javascript, and no doubt - every glitch de-bugged makes it even more amazing to traverse.
Firstly, transcend that baffling issue where the 'Create Instance' cancel button decided to go MIA. In this version, the cancel button has been tamed and will obediently revert operations upon command. Confusing encounter while trying to cancel? Not on our watch.
Next, ghosts in the machine leaving your instances inactive for real-time events have been banished. Say farewell to instances hitting the snooze button. Brace yourself for instantaneous reactions, as keeping up with real-time events is now a breeze.
Finally, cue the drumrolls for back-end compatibility upgrades. Seamless support for PocketBase 0.9.0 and 0.9.1 has been meticulously architected. Now, you can straddle comfortably between these versions, without breaking a sweat.
In conclusion, PocketHost 0.5.4 is an engaging ride onwards and upwards, taking us a step closer to an even more splendid user experience. Plug in the code, grab some coffee, and watch the magic unfurl.
- fix: Create Instance cancel button does not work
- fix: instances do not stay active for realtime events
- chore: support for PocketBase 0.9.0 and 0.9.1

21
packages/www/content/blog/0.5.5.md
View File

@ -1,8 +1,25 @@
---
title: PocketHost 0.5.5
description: A new version of PocketHost has been released.
date: 2022-12-18
date: 2022-12-18T00:00:00.000Z
description: Unleashing the latest updates on PocketHost - now bumped up to
version 0.5.5! Seamlessly integrate with the newest PocketBase versions 0.9.2,
0.10.0, and 0.10.1. Dive into the world of swift project deployment with this
exciting edition of PocketHost.
---
# Overview
---
Buckle up, fellow coders, PocketHost has propelled into new frontiers with its latest software upgrade to version 0.5.5! In this update, we’re granting seamless integration with the freshest editions of PocketBase; namely version 0.9.2, 0.10.0, and 0.10.1. With this exciting evolution of PocketHost, expanding the findings in your codeverse just went from Warp to Ludicrous Speed.
Our new 0.5.5 edition of PocketHost handles all your behind-the-scenes tasks, so you can laser focus on crafting superb applications. We spin up instances of PocketBase - with versions 0.9.2, 0.10.0, and 0.10.1 - quicker than you can unravel a Rubik’s cube. It's like having Q from James Bond in your corner, crafting all the DevOps and Linux gadgetry.
With this upgrade, PocketHost has leveled up to become your ultimate ally in web development. Each instance of PocketBase is dedicatedly engineered to put efficiency and convenience at the helm of all your operations, serving as your ride-or-die companion in your coding conquests.
So embrace the power of PocketHost to whip up next-level creations and conquer the galaxy of enterprise-grade applications, faster than a speed-dating algorithm at a Hackathon! Make peace, too, with those DevOps tasks that are about as approachable as a box of Schrodinger’s cats. Welcome to a whole new dimension of deployment. Confidence level: Tony Stark on espresso.
Now, venture forth and boldly code where no dev has coded before. With PocketHost 0.5.5, the code-verse is your oyster!
- chore: PocketBase 0.9.2 update
- chore: PocketBase 0.10.0, 0.10.1 updates

28
packages/www/content/blog/0.5.6.md
View File

@ -1,8 +1,32 @@
---
title: PocketHost 0.5.6
description: A new version of PocketHost has been released.
date: 2022-12-24
date: 2022-12-24T00:00:00.000Z
description: PocketHost 0.5.6 rolls out a game-changing update, ditching Docker
and introducing PocketBase 0.10.4! Compatible across all your NodeJS
programming needs, our latest version promises efficiency, stability and
commitment to keep your coding streamlined and carefree, while you focus on
what truly matters - your creation.
---
# Overview
---
title: Salutations from PocketHost 0.5.6!
date: 2022-12-24T00:00:00.000Z
description: Unveiling PocketHost 0.5.6, a game-changing episode coming in hot, parting ways with Docker and tying up with PocketBase 0.10.4. Custom-built for all the NodeJS maestros out there, the latest take aims at delivering efficiency and stability. A commitment to streamline your programming sail and free you from hitch, so you can anchor all your focus where it truly belongs – your masterpiece.
---
Unravel PocketHost's latest update which turns the tables effectively. Docker gets a courteous bow out, making room for bigger and better. Now, you dive straight into the core, fine-tuning your projects with increased proficiency and zero distractions.
Embrace the new and upgraded PocketBase 0.10.4. This version offers you unmatched compatibility across all your NodeJS endeavors. It's all-inclusive, reliable, and designed to line-up your coding experience - efficient and carefree.
Consider this as a redefined commitment from PocketHost - a promise to keep your coding streamlined, no distractions, only creativity. Your creations are the stars here; PocketHost 0.5.6 is just the robust rocket fuel propelling them to the skies. So, get ready to celebrate more freedom and fewer hiccups; the new era of NodeJs programming has begun.
Remember, it's the dawning of a new age in the realms of PocketHost and you're in for a whirl. This step forward is sure to change the game. Buckle up, developers, it's about to get exciting!
- Remove Docker
- PocketBase 0.10.4 update

22
packages/www/content/blog/0.5.7.md
View File

@ -1,9 +1,27 @@
---
title: PocketHost 0.5.7
description: PocketHost 0.5.7 has been released.
date: 2022-12-26
date: 2022-12-26T00:00:00.000Z
description: Dive into the nitty-gritty of the new PocketHost 0.5.7, launched on
the 26th of December, 2022! With the addition of superior PATCH and DELETE
CORS operations, PM2 production, and an innovative 'auto-upgrade' feature with
SemVer tagging, this update resolves a myriad of production errors. It's a
game-changer for NodeJS developers!
---
# Overview
Prepare for a quantum leap in your development cycle, NodeJS wizards! Exiting from time's tunnel is the innovative majesty - the PocketHost version 0.5.7, punctually delivered on 26th December 2022. This upgrade isn’t just Christmas-gift-wrapped graham crackers, it redefines game rules!
This update not only rectifies a constellation of lurking production errors but also transcends them into the realm of the forgotten past. Bid goodbye to unattended issues and invite a future of seamless code execution.
Confidently harness the power of PATCH and DELETE CORS operations, now an integral part of PocketHost's capabilities. No stone left unturned, no HTTP method left unsupported, right?
Next, be stoked about the addition of PM2 production support, a sturdy engine to propel your applications into the land of user delight. Excellent, for applications that need to survive application crashes and unexpected system reboots.
Lastly, the cherry on the top of this node.js sundae - an inventive 'auto-upgrade' feature with SemVer tagging. It's "The One With SemVer Tagging", promising a curve of continuous improvement rather than erratic jumps. The kind of predictability software developers (and Ross Geller) would appreciate.
- Fix various production errors
- Support PATCH and DELETE CORS operations
- Add pm2 production support

17
packages/www/content/blog/0.6.0.md
View File

@ -1,9 +1,22 @@
---
title: PocketHost 0.6.0
description: PocketHost 0.6.0 has been released.
date: 2022-12-31
date: 2022-12-31T00:00:00.000Z
description: Delve into the latest updates of PocketHost 0.6.0 in this blog
post. Explore the newly integrated FTP support, discover improvements in
instance uptime, learn about cached PocketBase releases, and the bid adieu to
the troublesome CORS PUT issue of the past.
---
# Overview
Behold, the fresh-off-the-coding-desk PocketHost 0.6.0! Tap into it to traverse the new frontier of FTP support. Unleash the power to streamline your workflows, uploading and managing files directly as if PocketHost was your local drive, all while savoring the same top-notch security you have come to expect.
Turn your attention to the newly minted cache support for PocketBase releases. As cool as a cucumber storing power in its cells, caching means the latest PocketBase version is always a single tap away—no more waiting for updates. Just like Neo bending the Matrix, it's time to sidestep unnecessary download times and jump straight into the action.
Now, let's talk uptime. That elusive 99.999% target is looking closer than ever, with enhancements to instance uptime ramping up reliability. Immerse yourself in a world where your creation is readily available, keeping both you and your users smiling.
Last but not least, put your hands together for the resolution of the CORS PUT issue. No more dealing with that pesky bug that left many scratching their heads like a glitch in the Death Star's plans. With the advent of PocketHost 0.6.0, that troublesome issue has been banished to the annals of history. Onwards and upwards, as they say!
- FTP support
- Cache pocketbase releases
- Enhance instance uptime

19
packages/www/content/blog/0.6.1.md
View File

@ -1,7 +1,22 @@
---
title: PocketHost 0.6.1
description: A new version of PocketHost has been released.
date: 2023-01-08
date: 2023-01-08T00:00:00.000Z
description: Delivering a fresh update on PocketHost 0.6.1, with a brisk fix
on a pesky semver locking error. Dive in to find out how this refined version
can streamline your web development journey and ignite unparalleled
efficiency. Touch base with the future of a zero-config world.
---
# Overview
---
Inject a bit of swagger into your backend development with PocketHost 0.6.1. Primed, polished, and pretty darn resistant to errors - especially that tough nut semver locking error. That bugger's been swatted out into the oblivion of coding history.
Picture yourself steering clear of those quirky semver locking issues, navigating smoothly through your NodeJS endeavors. Imagine the delight of uninterrupted flow, with PocketHost 0.6.1 as a steadfast companion. This update might as well be the duct tape for your persistence bloopers - it's the force field that keeps the semver glitches at bay.
Let's dig into the magic potion that makes PocketHost 0.6.1 truly extraordinary. The semver locking error, a classic stumbling block in the developer's journey, no longer poses a threat. Eradicated, deleted, fixed. That notorious error message that used to send chills down your spine? Evaporated into thin air!
So how does streamlining your web development journey sound? Fancy igniting unparalleled efficiency on your path to creating tomorrow's online innovations? Reach out and seize the day with PocketHost 0.6.1. Step into a zero-config world and let this edition turbocharge your proficiency. Trust in PocketHost to helm your creations, as we usher-in an era where open-source technologies hold the reins, making software development as seamless as a jiu-jitsu transition.
- Fixed semver locking error

20
packages/www/content/blog/0.7.0.md
View File

@ -1,8 +1,24 @@
---
title: PocketHost 0.7.0
description: Migration support
date: 2023-06-08
date: 2023-06-08T00:00:00.000Z
description: Experience effortless backend management with the latest PocketHost
0.7.0! It now natively integrates PocketBase updates, with the addition of
migration features, letting your projects be as agile as you are. Dive into an
era where lean development meets power-packed features. Maintenance mode,
updates and migrations are now simpler than ever.
---
# Overview
Dive headfirst into an era of streamlined development with the latest PocketHost update, version 0.7.0. Fully loaded with native PocketBase integration and a new suite of features, this update brings you the future of agile project management - turning your backend administration blueprint on its head.
Here's the crux of what's new: from the get-go, every fresh instance you fire up will now automatically generate and run with the most recent version of PocketBase. This feature, once benched pending PocketBase's maturity, is now rolled out and ready to rumble. Trust us when we say it's game-changing.
There's more spice in the mix. PocketHost 0.7.0 now natively uses PocketBase migrations to manage the central database migrations of PocketHost itself. This means that every intricacy of your backend management, including maintenance mode, updates, and migrations, will be as smooth as butter.
But wait, there's a bonus level! Your voice and suggestions matter. The roadmap is updated and plans are afoot to enable you, the end-user, to initiate a maintenance mode protocol for your PocketBase instance, and run migrations from your dashboard. Get ready to embrace this brave new world of seamless backend project management!
- PocketHost will now always select and run the latest version of PocketBase for new instances and for the PocketHost central database. This was previously restricted until PocketBase matured more, but we think it is safe now.
- Now using native PocketBase migrations to manage PocketHost central database migrations. Roadmap has been updated with task to allow end users to put their PocketBase instance in maintenance mode and run migrations.

21
packages/www/content/blog/0.7.1.md
View File

@ -1,9 +1,26 @@
---
title: PocketHost 0.7.1
description: A new version of PocketHost has been released.
date: 2023-01-23
date: 2023-01-23T00:00:00.000Z
description: PocketHost, the highly accoladed 'PockerBase in the cloud' service,
has rolled out its v0.7.1 update. This maintenance release showcases improved
FTP access, static assets management, error handling, plus a number of
essential fixes while introducing an FAQ section and transitioning the docs to
GitBook. Over 2000 users have been discussing these features in the cloud!
---
# Overview
Capture the upgrade in your coding adventure with the rollout of PocketHost 0.7.1, the cutting-edge update to the 'PocketBase in the clouds.' Explore enhanced FTP accessibility, superior handling of static assets, and refined error management. Delve into essential fixes while unlocking the mysteries of an added FAQ section and transitioned docs to GitBook.
PocketHost, your key to zero-config, 'PocketBase in the cloud' platform, has touched down with v0.7.0 today. The stats speak to the success, with an impressive 317 GitHub stars, almost 2000 registered users, approximately 2500 instances created, and a whopping ~ 1.5 million instance invocations.
The living testament to the power of PocketHost is the tell-all FAQ section and the roadmap that keeps you updated with all the happenings in the cloud. With this release, solve FTP username link URLencoding issues, explore the terrain of routing static asset requests to the PocketBase instance, and handle http-proxy error conditions like a pro. The transition to GitBook enhances your journey while various internal error trapping and logging help to deflate potential errors.
PocketHost 0.7.1 is not just an upgrade. It's your portal to elevate the quality of your technical prowess. Get into the rhythm of things, upgrade your PocketHost and let the creative coding get kicked up a notch.
PocketHost, the zero-config 'PocketBase in the cloud' platform, has reached v0.7.0 today. Thank you for everyone's continued support for this project.
Check out the [FAQ](../overview/faq.md) and [roadmap](../overview/roadmap.md) for more details.

22
packages/www/content/blog/0.7.2.md
View File

@ -1,9 +1,25 @@
---
title: PocketHost 0.7.2
description: With this release, you can now adjust the PocketBase version. It will accept semantic versions and semantic version ranges.
date: 2023-06-14
date: 2023-06-14T00:00:00.000Z
description: Discover PocketHost 0.7.2, the latest update to your favorite cloud
solution for PocketBase. Experience new features including adjustable
PocketBase versions, improved UI, and more. With over 326 Github stars, 2000
users, 2500 instances created, and 1.5 million executions - PocketHost
continues to be the ultimate zero-config platform.
---
# Overview
In the realm of user-friendly, zero-config platforms, PocketHost shines even brighter with its latest release, 0.7.2. Depth up the ante on your cloud solution prowess with this update that buzzes with exciting new features, including the much-anticipated ability to adjust your PocketBase version!
Dive straight into the mix by experimenting with semantic versions and semantic version ranges. But don't worry about causing a retrograde mess, PocketBase has got your back! It refuses to run on an older database version, saving you from an accidental rolls back to earlier, less efficient versions.
Sprinkled across our change log this time, you'll find a blend of cosmetics and cleanups: CSS enhancements, backup and restore UI cleanup, to name a few. Our log context update and singleton base config are some other tweaks we're pretty chuffed about.
And somewhere amidst all that code magic, we managed to clock a few personal records too. With a whopping 326 Github stars, about 2000 registered users, and over 1.5 million instance invocations to our glory, we've got plenty reasons to celebrate. And so do you. After all, about 400 of you have kept your instances active in the past week. That's evidence of an engaged community and a tribute to the power of PocketHost. Thanks for sticking around!
PocketHost is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
## What's New
@ -35,5 +51,3 @@ With limited testing, it seems that PocketBase will refuse to run on an older ve
- ~2500 instances created
- ~1.5 million instance invocations to date (# times PocketBase executable has been launched)
- ~400 instances active and used in the past week. This tracks, about 15% of instances are in active use.
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

22
packages/www/content/blog/0.8.0.md
View File

@ -1,9 +1,25 @@
---
title: PocketHost 0.8.0
description: 'Major release: new UI, rename instances, maintenance mode, instance permalinks, and more.'
date: 2023-06-19
date: 2023-06-19T00:00:00.000Z
description: PocketHost 0.8.0 brings the future of cloud hosting platforms to
Nodejs developers with major improvements like instance renaming, enhanced
stability, stress testing, Maintenance Mode & a cranked up UI. Get ready to
supercharge your PocketBase deployment like never before with faster
operations and a sleek, intuitive control panel.
---
# Overview
Dive into the new world of cloud hosting with PocketHost 0.8.0 tailored exclusively for Nodejs developers. This paradigm-shifting update revamps the already robust PocketHost by adding a plethora of new enhancements. Expect a sleeker, intuitive control panel alongside faster operations to supercharge your PocketBase deployment without batting an eye.
Midnight oil was burned redesigning the instance user interface on the dashboard, bringing you more structure and lucidity. Beware of the added _Danger Zone_—a trapdoor leading to the potentially destructive settings for your beloved PocketBase instance. Fear not at the sight of the unknown; for the first time, instances can be renamed offering a new level of personalization to your cloud terrain.
PocketHost 0.8.0 gives you the reigns of your instance with Maintenance Mode—allowing you to disengage running copies and keep them inoperational until you see fit. This proves vital during backups and restores, making them a breeze. Underneath this delightfully tidy UI and heightened control, this update hides a heart of iron. The code managing the launch and closure of instances underwent a complete overhaul, optimizing for superior stability and performance.
So, strap in, and prepare to traverse the cloud-scapes of PocketHost 0.8.0 with a heightened sense of control, crystal clarity, and unshakable stability. Be forewarned, this journey isn’t for the faint-hearted!
PocketHost is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
## What's New
@ -89,5 +105,3 @@ Each release of PocketHost is now tested with 500 simultaneous requests to hundr
- ~2700 instances created
- ~1.5 million instance invocations to date (# times PocketBase executable has been launched)
- ~400 instances active and used in the past week
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

20
packages/www/content/blog/0.8.1.md
View File

@ -1,9 +1,23 @@
---
title: PocketHost 0.8.1
description: 'Maintenance release: performance improvements, code enhancements, chores'
date: 2023-06-23
date: 2023-06-23T00:00:00.000Z
description: Explore the game-changing 0.8.1 update of PocketHost, your
zero-config 'PocketBase in the cloud' solution, primed with improved instance
launching, enhanced logging, and refined UI. Join 2000+ developers in enjoying
the comfort of seamless back-end deployment in over 2700 instances with this
increasingly popular go-to platform.
---
# Overview
Dive straight into PocketHost 0.8.1, the latest upheaval in your go-to 'PocketBase in the cloud' platform, set to transform backend deployment. This solution is making waves in the dev community, thanks to its ever-improving functionality and commitment to a zero-config ethos.
Explore a plethora of improvements in this maintenance release. Notice snappier instance launching performance, refactored Danger Zone UI, extensive logging - a debuggers dream, RPC callback fixes, corrections to documentation typos, and thorough database migration cleanups. From stressor updates to error propagation enhancements in RpcService, this release has fine-tuned the PocketHost experience, emphasizing accuracy and user convenience.
Finally, don't underestimate the impact of this update in the context of impressive growth stats. Over 2000 developers are now harnessing this tool across the development spectrum, with approximately 2700 instances created and an astounding 1.5 million instance invocations so far. With around 400 instances deemed active in the past week, there's no doubt that PocketHost 0.8.1 is not just an update but a significant gear shift for modern NodeJS developers. Therefore, probe into this platform and elevate your backend deployment game.
PocketHost is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
## What's New
@ -72,5 +86,3 @@ Highlights:
- ~2700 instances created
- ~1.5 million instance invocations to date (# times PocketBase executable has been launched)
- ~400 instances active and used in the past week
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

24
packages/www/content/blog/0.8.2.md
View File

@ -1,9 +1,27 @@
---
title: PocketHost 0.8.2
description: Unzip fixes and FTP enhancements
date: 2023-07-15
date: 2023-07-15T00:00:00.000Z
description: Discover what's new in PocketHost 0.8.2, the latest maintenance
release for your favorite zero-config 'PocketBase in the cloud' platform.
Explore our improved logging, FTP enhancements, database migration cleanup,
and much more. Stay current and enhance your NodeJS development experience
with these updates.
---
# Overview
Witness the latest chapter of the PocketHost journey unfold with the release of version 0.8.2. This iteration, a ‘nuts and bolts’ maintenance release, focuses on ensuring your 0-to-60 transition to a live PocketBase instance—with zero-config—is smoother than ever.
Delve into the enhanced logging system, designed meticulously for in-depth debugging. Let the FTP enhancements streamline your workflow while the database migration cleanup keeps things tidy in the backend. Pointedly, don't miss the refactored 'Danger Zone' UI— it's designed to keep you safe while still living on the edge.
Keen eyes might spot a fix for the ‘unzipper’ package failing on node v18.6.0 that was inconspicuously wreaking havoc during PocketBase version upgrades. On the same note, service templates have undergone precise recalibrations, and the `node` version is now steadfastly locked.
An array of behind-the-scene chores adds robustness while a refactored UpdaterService compliments these under-the-hood improvements. Look out for changes related to the PocketBase service and SQLite patch updates. There’s also the intro of 'stresser' and 'stresser cleanup' for those who love to push the boundaries.
The narrative of PocketHost v0.8.2 is written in its changelog. The numbers speak volumes with 359 GitHub stars, over 2000 registered users, and more than 400 instances active in the past week alone. Dive in and optimize your NodeJS experience with PocketHost 0.8.2.
PocketHost is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
## What's New
@ -45,5 +63,3 @@ Highlights:
- ~2700 instances created
- ~1.8 million instance invocations to date (# times PocketBase executable has been launched)
- ~400 instances active and used in the past week
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

22
packages/www/content/blog/0.9.0.md
View File

@ -1,10 +1,24 @@
---
title: PocketHost 0.9.0
description: Cloud functions (pb_hooks support), many fixes and chores
date: 2024-01-23
date: 2023-10-01T00:00:00.000Z
description: PocketHost 0.9.0 introduces several improvements, including
PocketBase JS Hooks support, Docker containment for instances, a shift to
Static Site Generation (SSG) for the UI, better logging, and deeper secrets
integration. Join the discussions about upcoming v1.0 features and paid tiers
on our dedicated Discord server.
---
# PocketHost 0.9.0 Release Notes
# Overview
Get ready to dive into the newest chapter of the PocketHost saga with the latest 0.9.0 release, offering some major enhancements that'll spring your productivity into overdrive.
Take control with the new PocketBase JS Hooks support. All hail the `pb_hooks` directory, a new playground for your wildest Javascript explorations. As a result, Deno worker support took the backstage, but rest assured, it's for a good reason: the stability of the sailing ship that is the PocketHost-PocketBase alliance.
Expect an extra layer of robustness as instances now run in Docker containers. It's a necessary security guard ensuring every instance holds its ground securely without interfering with the others. Bear with us on this one - we're expecting a little turbulence as we calibrate the Docker influence on the platform.
Witness the speed of light with Static Site Generation (SSG) on the new-look frontend, now hosted on Cloudflare Pages. It's as if the Mothership running in San Francisco engaged hyperdrive, promising almost instant load times, and delivering a huge upgrade in user experience.
For an in-depth look at all the enhancements and discussions around v1.0 and its potential paid tiers, hop onto our dedicated Discord server. Your input might just influence the future face of PocketHost. Get your hands on the project now - this ride to fantastic, efficient web hosting is only just beginning.
PocketHost is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
@ -136,5 +150,3 @@ Already green-lit and under active development:
| invocationSeconds1Day | 842562.3680000034 |
| invocationSeconds7Day | 5469632.9049999295 |
| invocationSeconds30Day | 18793014.398999963 |
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

22
packages/www/content/blog/0.9.1.md
View File

@ -1,9 +1,25 @@
---
title: PocketHost 0.9.1
description: Updated docs
date: 2023-10-02
date: 2023-10-02T00:00:00.000Z
description: Discover the latest enhancements in PocketHost 0.9.1, the
zero-config 'PocketBase in the cloud' platform. This maintenance release
brings significant improvements to documentation, code refactoring, and a
better proxy error trapping. Dive into new features, bug fixes, and a
refreshed marketing approach, all geared to improve your coding experience.
---
# Overview
Gear up and venture forth into the labyrinth of coding realms with PocketHost 0.9.1. No need to pack your own provisions. This zero-config 'PocketBase in the cloud' platform caters to your every software-dev whim like a Gandalf-grade wizard; all magic, no tricks.
Take a deep breath and plunge into a maintenance release that sets new standards with mind-blowing enhancements. Crisp, clear documentation is like the 'Alexandria Library' for developers, letting you absorb knowledge as effortlessly as Neo in the Matrix. Code refactoring, continuous integration, and glistening Github actions are the invisible threads that weave the fabric of a well-optimized and seamless dev journey. Don't forget the garnish; the pièce de résistance is the enhanced proxy error trapping, alerting you like Spidey Senses on Red Bull.
Unpack a treasure trove of changes in the latest changelog. From hoisting micro-dash, typefest and chalk, to our own PocketHost JS SDK, and a prettier-update, it's like discovering alien tech in your backyard. We've dealt with bugs like Thor deals with misbehaving minions, squashed and silenced for good. Finally, emerge into a Keto diet for marketing - lean and powerful with documentation links bolstered by a rejuvenated marketing and docs site.
Bear in mind though, it's not a stroll in the park. Embrace the power of PocketHost 0.9.1, and carve your own path through the mystical dev realms.
[PocketHost](https://pockethost.io) is the zero-config 'PocketBase in the cloud' platform. Thank you for everyone's continued support for this project.
## Maintenance Release
@ -39,5 +55,3 @@ This release includes enhancements to:
- enh: rename pockethost.io to dashboard
- docs
- docs: prod notes
Check out the [FAQ](https://pockethost.io/docs/overview/faq) and [roadmap](https://pockethost.io/docs/overview/roadmap) for more details.

20
packages/www/content/blog/awesome-pocketbase-20-and-growing.md
View File

@ -1,9 +1,25 @@
---
title: awesome-pockebase has 20+ community resources and growing
description: awesome-pocketbase is growing
date: 2022-10-27
date: 2022-10-27T00:00:00.000Z
description: In our incredible developer-centric GitHub, awesome-pocketbase, we
now have over 20 thriving resources for PocketBase users. From Python SDKs to
SQLite tools, and even starter kits, the community is putting together some
exceptional tools to amplify your experience. If you've created a project for
PocketBase yourself, reach out! We'd love to feature you.
---
# Overview
Dive into the expansive universe of PocketBase on GitHub, courtesy of the meticulously curated https://github.com/benallfree/awesome-pocketbase. It's your immediate gateway to a galaxy that now boasts over 20 vibrant community resources and counting. Python SDK may have been the latest pioneer, but it's one of a rather intriguing line-up.
Explore the terrain that includes everything from starter kits to demo apps, samples tailored to distinct languages and frameworks, a toolbox of SQLite resources, and much more. But it doesn't end there! If you have been tinkering away, creating a project for PocketBase, then it's time for you to step into the spotlight.
Make sure to establish a connection and get listed. There's a thriving community of fellow explorers eagerly awaiting the chance to draw on your PocketBase project. Get involved, share your work, and be part of this flourishing ecosystem.
Don't just concede to the magic of PocketBase. Amplify it! Raise your voice, showcase your project, and help librate the full potential of PocketBase with your contributions. This is your call to action. Connect, create, and conquer. Let's make PocketBase even more awesome than it already is!
I maintain https://github.com/benallfree/awesome-pocketbase. We have over 20 community resources (Python SDK is the latest addition). The resources include starter kits, demo apps, language- and framework-specific samples, SQLite tools, and more. Check it out!
If you are the maintainer of a project for PocketBase, please connect with me to get listed.

16
packages/www/content/docs/development/frontend.md
View File

@ -1,9 +1,23 @@
---
title: Just the frontend (Svelte)
category: development
description: How to work with the frontend only
description: Learn how to focus purely on UI and frontend development using
Svelte with pockethost.io. Simply clone our repository, install the needed
packages and start a local build to connect directly to the `pockethost.io`
mothership for seamless database tasks. No backend setup, all fun and
function.
---
# Overview
Relishing the thrill of frontend development without diverting focus towards backend areas is a compelling prospect. To truly immerse yourself in Svelte, `pockethost.io` makes it convenient to concentrate solely on UI and frontend tasks. An easy way to initiate this is by cloning the `pockethost.io` repository. This makes an effortless bridge for your local build to communicate with our resourceful mothership.
A quick tour through the following commands eradicates any need for backend setup. Begin by cloning the repository with `git clone git@github.com:benallfree/pockethost.git`. Following that, navigate to the newly cloned directory using `cd pockethost`. The command `yarn` will install all required packages, then `yarn dev:www` starts a local build.
That's the magic. You're now in the throes of a seamless frontend undertaking. The `pockethost.io` mothership oversees your Svelte build ensuring it has resources to handle all database-related exercises. By deploying this approach, you get to relish the strengths offered by Svelte, while we shoulder the backend burden. Enjoy the freedom of crafting your UI innovations without unnecessary backend tangles.
Just want to work with the UI and frontend?
```bash

16
packages/www/content/docs/development/full-stack/dnsmasq.md
View File

@ -2,9 +2,23 @@
title: Never touch your local /etc/hosts file in OS X again
category: development
subcategory: full-stack
description: Set up your computer to work with \*.test domains, e.g. project.test, awesome.test and so on, without having to add to your hosts file each time.
description: Learn how to streamline your developer experience by setting up
your computer to automatically handle *.test domains using Homebrew and
Dnsmasq. Say goodbye to manually editing your hosts file each time. This guide
offers an easy-to-follow process for both setup and testing, ensuring smoother
project management and development.
---
# Overview
Ever had to edit your /etc/hosts file on your OS X machine each time you spin up a new *.test domain? If so, you know it can be a manual, time-consuming process. But, good news! I'm about to teach you how to automate this using Homebrew and Dnsmasq. With the right setup, your computer will handle these domains effortlessly, streamlining your developer experience.
To get started, you'll need Homebrew installed. Next up, you'll install Dnsmasq using a simple brew command. You'll then create a specific config directory, followed by setting up your *.test domains, and configuring the port to the default DNS port. It may sound a bit technical, but don't worry, I've got you covered with a step-by-step guide.
Once the setup is complete, we will move on to autostarting it now and setting it to autostart after each reboot. Then, onto the fun part, testing! We'll test the new setup, create a resolver directory and add your nameserver to the resolvers. The aim is to ensure smooth project management and development, and most importantly, never having to manually edit your hosts file each time you create a new *.test domain. Rejoice in the simplified brilliance of your new development process!
> To set up your computer to work with \*.test domains, e.g. project.test, awesome.test and so on, without having to add to your hosts file each time.
## Requirements

18
packages/www/content/docs/development/full-stack/etc_hosts.md
View File

@ -2,9 +2,25 @@
title: Manually set up `/etc/hosts`
category: development
subcategory: full-stack
description: If you can't use dnsmasq or equivalent, you can still configure hosts manually.
description: Learn how to manually configure your host entries with PocketHost
for developers who can't utilize dnsmasq or similar tools. Navigate a slightly
streamlined dev experience while you expand your project's reach using
PocketHost, with support for as many '*.pockethost.test' subdomains as
required.
---
# Overview
It's possible to manually fine-tune your host entries with PocketHost, particularly when dnsmasq and related tools are out of the question. This method offers a slightly stripped-down but nonetheless effective developer experience. Further, it supports an unlimited number of '*.pockethost.test' subdomains, enabling you to touch a wider audience as you grow your project with PocketHost.
Seize control by adding host entries to the `/etc/hosts` file. Begin by bringing up the file with a text editor like nano. Lines specified under the file associate IP addresses with host names.
Here, `127.0.0.1` directs to your local machine. Following it, you'll add 'pockethost.test'—the main domain—along with other subdomains like 'pockethost-central.pockethost.test'—the primary PocketBase instance—and 'test.pockethost.test'—an illustrative PocketBase instance at the user level.
The manual method requires specifying subdomains individually as `/etc/hosts` doesn't interpret wildcards. Therefore, you're required to add as many '*.pockethost.test' subdomains as necessary for testing manually. Although slightly more time-consuming, taking this approach ensures a steadfast connection between your development environment and PocketBase through PocketHost.
If you can't use [dnsmasq](/docs/development/full-stack/dnsmasq/) or equivalent, you can still configure hosts manually. The dev experience will be slightly more limited, but it will still work.
**1. Add host entries to `/etc./hosts`**

15
packages/www/content/docs/development/full-stack/index.md
View File

@ -2,9 +2,22 @@
title: All our base
category: development
subcategory: full-stack
description: How to run the pockethost.io stack locally
description: Explore how to run the entire pockethost.io stack locally, from
setting up local SSL wildcard domain to launching the platform. This guide
covers the necessary preparations and gives a step-by-step walkthrough to run
in dev mode, making backend setup a breeze, even in a local environment.
---
# Overview
It's time for some thrilling backstage moments with pockethost.io! We've always loved the idea of you diving deep into our inner mechanics here at PocketHost. Why should cloud hosting have all the fun, right? So let's hit the ground running and explore how you can operate the entire pockethost.io stack right from your local environment, from configuring a local SSL wildcard domain to getting the platform up and running.
Let's be clear, this isn't beginner stuff. You can run the entire stack locally and that's no small feat. This means you can spin up a complete PocketHost platform on your personal machine, making your local back-end environment mirror that of production. This comes in handy for debugging, new feature development or just to gain a solid understanding of how the gears of PocketHost mesh together.
Moving on, you should note that you need a local SSL wildcard domain set up to get started. For our OS X users, if you encounter difficulty running `pocketbase`, your machine's security settings could likely be the impediment. Fear not, a helpful link has been included for troubleshooting this common hiccup. Now that we've got that covered, my friends, it's time for some hands-on action with pockethost.io in your own habitat!
Stay patient, stay curious, and above all, remember: Movement defines everything we do, whether it's a line of code or a jiu jitsu match! Let's put that core philosophy into practice.
The entire pockethost.io stack can be run locally.
**Prerequisites**

16
packages/www/content/docs/development/full-stack/local-domain-setup.md
View File

@ -2,9 +2,23 @@
title: Local Domain Setup Instructions
category: development
subcategory: full-stack
description: How to set up your local development environment to recognize wildcard domains with SSL.
description: Configure your local development environment to use wildcard
domains with SSL for the full Dockerized stack for PocketHost. This guide
covers steps from generating a root certificate for self-signing, approving
the self-signed certificate in your browser, generating a wildcard domain
certificate, to configuring your machine for wildcard localhost domains.
---
# Overview
In developing the full Dockerized stack for PocketHost, we're faced with the challenge of configuring our local dev environment to recognize wildcard domains operating via SSL. This may seem intimidating at first, but we've got it all covered in a few planed out steps.
Start by generating a root certificate for self-signing with the `create-ca.sh` script found in the `ssl` directory. The self-signed certificate needs your approval in your web browser to function correctly. If you follow the workflow using FireFox OS X, it's a straightforward process: navigate to your settings page, search for 'cert', opt for 'View Certificates', and finally import `ca.crt` under the `Authorities` tab. For other browsers or operating systems, consult the instructions laid out on BenMorel's dev-certificates GitHub repository.
Next, it's vital to devise a wildcard domain certificate for `pocketbase.test`. Then gear up your machine to be familiar with wildcard localhost domains. Operating on OS X? Refer to the listed dnsmasq instructions. Don't forget to restart dnsmasq services each time. If you're not up for using dnsmasq, manual `/etc/hosts` setup instructions are right there for your convenience.
This document covers how to set up your local development environment to recognize wildcard domains with SSL. Developing the full Dockerized stack for PocketHost requires these steps.
**1. Generate a root certificate for self-signing.**

14
packages/www/content/docs/development/overview.md
View File

@ -1,9 +1,21 @@
---
title: Developing PocketHost
category: development
description: Overview of the PocketHost development process
description: Learn how to develop PocketHost, a powerful, open-source, nodejs
application that enables swift multi-tenant platform functions. Ideal for
public or private use, PocketHost is beginner-friendly with plenty of
front-end modifications, while offering complex backend setup opportunities
for seasoned developers.
---
# Overview
Are you hungry for some development magic? We've got something exciting on the table- PocketHost, a robust open-source Node.js app that fuels pockethost.io. Harness the power of PocketHost to run your very own private or public multi-tenant platform. It's a feast for developers at all levels, chock-full of engaging front-end modifications for beginners and intricate backend setup options for the experienced.
PocketHost runs purely on Node.js, carrying forward our legacy of keeping things straightforward and efficient. Previously, we operated within a Docker container, but at PocketHost, we're all about elevation and evolution. We realized the potential to boost our efficiency standard and seized the chance, shifting to a pure Node.js stack.
If you're eager to bring new ideas to the table or to get your hands dirty tweaking existing ones, you're most welcome here! With PocketHost, you can easily modify the frontend, making it an excellent starting point. If you're experienced and up for a challenge, delve into modifying the backend. Although it requires extra setup, it's a journey certain to enrich your developer skills. At PocketHost, we believe in growing together, learning together, and creating together. And what's better? You get to do all this in your way!
This monorepo contains the entire open source stack that powers pockethost.io. You can use it to run your own private or public multitenant platform.
PocketHost is a pure nodejs application. It used to run in a Docker container, but it was eventually decided that a pure node stack was a better option.

19
packages/www/content/docs/development/production.md
View File

@ -1,9 +1,26 @@
---
title: Production Deployment
category: development
description: How to deploy PocketHost to production
description: Learn how to deploy your PocketHost project for production. This
guide covers building, refreshing Certbot, running tests, as well as updating
and maintaining PocketBase's max semver. Dive in and get your applications
running smoothly in no time.
---
# Overview
Deploying your PocketHost project for production may seem daunting at first, especially when your focus is primarily on code creation. But fear not, this guide will get you through the necessary steps to streamline your deployment process.
Begin by setting up your project. Use `git clone git@github.com:benallfree/pockethost.git` command, followed by `cd pockethost` to enter the directory. After you have initiated your project, you need to build it, and for this, you'll leverage `scripts/build.sh`.
Next, take a moment to refresh Certbot with `./scripts/certbot-refresh.sh`. This will help ensure your SSL certs are always up-to-date, with `fullchain.pem` and `privkey.key` keys in the `docker/mount/nginx/ssl`.
Then, you're ready to run the project. Launch your project using `sudo scripts/pm2.sh` and follow up with `sudo pm2 dash` to access the dashboard. At this point, navigate to `https://pockethost.io` to test the output.
Finally, update the max PocketBase semver to limit or lock the PocketBase versions available. All you need is to tweak the `DAEMON_PB_SEMVER` variable in `.env`. And there you have it, your PocketHost project is ready to go live!
## Summary
- `sudo crontab -e`

16
packages/www/content/docs/development/rpc.md
View File

@ -1,9 +1,23 @@
---
title: Creating RPC Calls
category: development
description: How to securely create RPC calls
description: Learn how to secure data modifications with PocketHost by creating
Remote Procedure Calls (RPC). Our guide comprehensively covers how to produce
new RPC calls, adjust the schema, and handle commands. Currently, only
asynchronous executions are supported, with returns from RPC calls
unavailable. Ideal for nodejs programmers seeking robust security measures.
---
# Overview
We all are quite aware of the security challenge one could face allowing direct modification of record by the frontend PocketBase client. That's where Remote Procedure Calls (RPCs) in PocketHost swing into action, coming to the rescue to ensure the vulnerable frontiers are secure. It gives you an opportunity to deal with mutable data safely by sending frontend RPC requests to the backend to process securely. The advantage of this? You're catering to imperfections in PocketBase admin security rules, and handling record update scenarios involving transactions, data validation, or specific condition requirements.
So, how do we add an RPC call to your PocketHost? It's simple - from your command line, execute `npx hygen rpc new <FunctionName>`, which effectively prepares the necessary files for your RPC call. Of course, you may need to tune the schema in `./packages/common/src/schema/Rpc/<FunctionName>.ts` to match your specifications. Follow it up by adjusting `./packages/daemon/services/RpcService/commands.ts` to receive the RPC command.
Now let's talk about the RPC results. Currently, you must be aware that we don't support RPC results, as they basically operate on an asynchronous basis. Essentially, you have managed to enhance your backend security layer by adding the robust RPC feature to your PocketHost.
For security, PocketHost does not allow modification of records by the frontend PocketBase client. Instead, the frontend must send an RPC request which the backend will securely process. This allows for many security vulnerabilities to be addressed which PocketBase admin security rules cannot. In particular, PocketBase admin security rules fall short in these scenarios:
- When the incoming data cannot be validated declaratively

17
packages/www/content/docs/hosting/overview.md
View File

@ -1,9 +1,22 @@
---
title: Overview
title: Getting Started
category: hosting
description: How to set up a production hosting environment for PocketHost
description: Explore how to set up a production-grade hosting environment for
PocketHost. Whether you crave control over underlying infrastructure or wish
to run it from unoffered regions, this guide provides needful insights into
managing Docker, handling DNS, provisioning SSL certs, and understanding cloud
computing or VPS deployment. Discover PocketHost's abilities to transform your
song.
---
# Overview
Power up your projects by hosting PocketHost independently. If control is what you crave, or your project operates out of pockethost.io's reach, then this guide is just what you need. Here, we unravel the intimidating knots of Docker management, DNS handling, and SSL certificate provisioning. We also offer a bird's eye view of both Cloud Computing and VPS deployment. In essence, you're about to embark on a DIY journey into the belly of PocketHost, and we're here to guide you.
Designing a hosting service isn't just ones and zeros; it's a test of your knowledge on a wide array of topics. Expect to challenge your understanding of email and SPF+DKIM, DNS terminology, storage management, volume mounting, and more. You'll also get a hands-on experience of AWS's functionalities. What's more, the trip includes valuable lessons in scaling, security, log rotation, patch management, update handling, build tools, and more.
Still intrigued by the idea of hosting your own PocketHost? Then let's delve into the practical realm. We'll kick off with the basics: updating your packages, installing necessary platforms and cloning repositories. Be prepared for an in-depth, step-by-step instruction, packed with actionable tasks. So grab your keyboards and get ready to explore a whole new horizon in PocketHost hosting.
[UNDER CONSTRUCTION]
This guide covers how to set up a production hosting environment for PocketHost. Hosting PocketHost might be desirable if:

26
packages/www/content/docs/introduction.md
View File

@ -1,12 +1,26 @@
---
title: Introduction
category: getting-started
description: How to get started with PocketHost in a few easy steps.
description: PocketHost, a powerful cloud hosting platform for PocketBase,
allows you to create unlimited projects quickly and easily. With no backend
setup required, it manages all the Linux/devops tasks, from email and DNS
jargon to SSL management and CDN hosting, so developers can solely focus on
building their apps.
---
## 👋 Welcome to PocketHost
# Overview
### Overview
Starting a new project on PocketHost is as effortless as creating a project on Firebase or Supabase. Simply choose a custom subdomain and each PocketBase instance is instantly provisioned and managed on `pockethost.io`. Our cloud-hosted environment is built with speed and scalability in mind, and you can access your PocketBase instance using the PocketBase JavaScript SDK. It's as simple as `new PocketBase('https://my-project.pockethost.io')`.
We know that many web and nodejs programmers choose SvelteKit, React, Vercel, Firebase, and Supabase for their ease of use. That's why we've mirrored that simplicity with PocketHost. Set up a live PocketBase instance with no backend setup. Once you've created an account at pockethost.io, you can provision your first PocketBase instance and connect from anywhere.
With PocketHost, you can forget about the time-consuming tasks of managing Linux/devops. We handle everything from email and DNS management to SSL certification, CDN hosting, and much more. This lets us give you more time to focus on what's really important: building your app and making an impact with your creation.
# 👋 Welcome to PocketHost
## Overview
PocketHost hosts your [PocketBase](https://pocketbase.io) projects, so you don't have to. Create a project like you would in Firebase and Supabase and let PocketHost do the rest.
@ -17,7 +31,7 @@ PocketHost is a cloud hosting platform for PocketBase. You can use it to instant
- Access your PocketBase instance using the PocketBase JavaScript SDK as easily as `new PocketBase('https://my-project.pockethost.io')`
- Run your instance in an ultra-beefy shared environment
### Focus on your app
## Focus on your app
Get a live PocketBase instance in 10 seconds with no backend setup:
@ -26,12 +40,12 @@ Get a live PocketBase instance in 10 seconds with no backend setup:
3. Connect from anywhere
```ts
import PocketBase from 'pocketbase';
import PocketBase from 'pocketbase'
const client = new PocketBase(`https://harvest.pockethost.io`)
```
### Batteries Included
## Batteries Included
Here's all the Linux/devops stuff that PocketHost does for you:

14
packages/www/content/docs/overview/faq.md
View File

@ -1,9 +1,21 @@
---
title: FAQ
category: getting-started
description: Frequently asked questions about PocketHost and pockethost.io
description: Explore frequently asked questions about pockethost.io, a
nonprofit, one-click hosting and deployment service for PocketBase projects.
Discover how PocketHost ensures stability, security, and offers a free tier,
including resources like FAQs on data backup, migration, pricing, usage
restrictions and more for both hobbyists and
---
# Overview
pockethost.io is a community-powered, non-profit hosting service for the PocketBase projects. Headed by seasoned programmer benallfree, it provides one-click hosting and deployment, allowing you to harness the power of PocketBase without the need to self-host or grapple with server setups. Furthermore, PocketHost provides a plethora of additional services such as backup, restore, SFTP access, static hosting, and much more, making it a useful tool for quick deployment of small to mid-scale PocketBase projects.
PocketHost employs the tested and stressed infrastructure daily ensuring stability and security for your data. You can back up and download your data at any time via SFTP and SSH with RSA-2048 encryption boosts security. PocketHost, developed with an understanding of the sovereignty principle of PocketBase, extends support to import data, facilitating easy migration process to and from the platform.
Creating as many PocketBase instances as needed is at the heart of PocketHost’s mission. The service caters to both hobbyists and professional developers; hence a free tier has been offered. This free tier grants you unlimited bandwidth, storage, and 100 CPU minutes each month allowing flexibility for users. Moreover, they're considering the inception of a paid-plan for power users which will come with added perks and unlimited resources. An interactive discussion area is maintained for further queries and to stay updated with the latest developments.
## About
### What is pockethost.io?

15
packages/www/content/docs/overview/help.md
View File

@ -1,9 +1,22 @@
---
title: Getting Help
category: getting-started
description: Getting help with PocketHost development or usage.
description: Learn how to get assistance with PocketHost, your one-click
deployment platform. Engage real-time in the PocketHost Discussions forum or
for more confidential matters, send a direct email to the developer. Get
started and harness the power of PocketHost now.
---
# Overview
Got queries on how to best use PocketHost for your projects? Let's clear them up, champ! The first stop is our buzzing [PocketHost Discussions](https://github.com/benallfree/pockethost/discussions) forum over at GitHub. It's the ideal platform for you to fire away your questions, sing praises, suggest features or even rant a little. We just ask that you take a stab at initiating a discussion before raising GitHub issues – let's keep things organized!
When you want to get into more confidential subjects or need specific assistance, feel free to drop an email to ben@pockethost.io. Also, don't forget, we have an active Discord channel - another great place to get real-time responses from our community. It's all about helping each other out to make our web development journeys more enriching and efficient.
So strap on your proverbial white belt and jump into the fray. Remember, when it comes to PocketHost, the only dumb question is the one you didn't ask. Use these resources to your advantage and get ready to grapple with the limitless potential of PocketHost. Now, who's ready for a roll on the digital canvas?
## Discussion Forum
The fastest and easiest way to get help is to head over to the [PocketHost Discussions](https://github.com/benallfree/pockethost/discussions) forum. Please do not create GitHub issues without initiating a discussion first.

16
packages/www/content/docs/overview/roadmap.md
View File

@ -1,9 +1,23 @@
---
title: Roadmap
category: getting-started
description: Planned features and known issues
description: Explore the PocketHost's roadmap and delve into the planned
enhancements for our cloud-based hosting and deployment platform. From
handling project instances and account management to CLI and backup features,
and even paid tier objectives - we are constantly working to improve your
experience with pockethost.io.
---
# Overview
Our main goal at PocketHost is ensuring that your projects are up and running without the unnecessary backend hassle, and to continuously refine this process. We strive to help you focus on what you love - creating - while we handle the nitty-gritty. Our roadmap includes enhancements across a variety of features, which we're excited to share.
Instance and Account Management features are set for a significant revamp. We're working on allowing you to power instances on and off, place them into maintenance mode, restart them, and even delete them. Account management will benefit from the ability to permanently delete an account or change the email address affiliated with it.
A big addition is a comprehensive Command Line Interface (CLI) feature for improved interaction with the platform. Enhancements include the ability to download and restore DB backups locally, deployment of static assets, and initialization of a new project, among others.
Looking towards the future, there are plenty of ideas buzzing around. From developing detailed video tutorials, mitigating storage partitioning, to integrating secure mail API credentials for your projects, we’re all about constantly growing and improving. And remember, we encourage your input along the way – it helps make PocketHost better! Your creations reflect you, and we're here to ensure they reach the world beautifully.
This document attempts to outline all known/planned issues.
Cleanup effort: In some cases, if a ticket has already been created, it is linked. The ticket will remain closed until active work begins. This better reflects the health of the repository because open issues creates the appearance of instability or lack of attention.

17
packages/www/content/docs/releases/next.md
View File

@ -1,3 +1,20 @@
---
title: Changes in `master` not yet released
description: Uncover the latest updates and changes made to the 'master' that
are yet not released. Stay tuned for a deep dive into these advancements to
comprehend how they can potentially enhance and revolutionize your experience
with PocketHost's features and functionalities.
---
# Overview
Stepping into the technical realm of mid-development updates, we aim to provide you with an insider's perspective on the alterations made to the `master` that haven't yet seen the light of the day in a release. Since it's still in the refining process, you can perceive this as a backstage pass that brings the upcoming modifications to PocketHost's functionalities into the spotlight.
Fresh off the coder's console, these modifications promise considerable potential to significantly upgrade your PocketHost experience. This includes enhancements across multiple aspects - adjustments that boost performance, augment security, and even some novel attributes that could transform how your projects are managed by the platform in a profoundly impactful way.
Delving a bit deeper, you'll find that these changes are pioneered by the philosophy of enhancing not just the software's efficiency, but also your interactive experience. As we simplify complex elements and amplify convenience factors, the prime focus pivots to you, the user - ensuring that you find ease and efficacy when creating and managing your projects using PocketHost.
In conclusion, the `master` holds a hidden trove of improvements designed to turbocharge your projects to previously unreachable heights. So, stay tuned, adopt a posture of learning and anticipation; these advancements are shaping up to redefine your journey with PocketHost.

14
packages/www/content/docs/usage/accessing-instance.md
View File

@ -1,9 +1,21 @@
---
title: Accessing Your Instance
category: usage
description: How to access your PocketBase instance.
description: Learn how to access your PocketBase instances managed by
PocketHost using uniquely assigned UUIDs or your personalized subdomains.
Discover how these instances, crucial for running projects like web games, can
also be renamed for convenient accessibility. Future updates include
anticipated support for custom domains.
---
# Overview
Let's dive into the crux of uncovering the inner workings of how to access your pervasive PocketBase instances, managed prudently by PocketHost. Crucial for running your avant-garde projects such as web games, these instances are the backbone of your application's backend. They can be approached via two easy gateways - you have the choice of using either the uniquely assigned, immutable UUIDs or your personalized, modifiable subdomains.
Every instance governed by PocketHost is labelled with a UUID that's like its indelible fingerprint. It's like the North Star - steadfast and unwavering no matter where you journey. Yet, as a programmer, you have the flexibility to choose your unique subdomains. Like pet names, these subdomains can be playful, meaningful, esoteric, or all of the above, free for you to change at will for convenient accessibility.
In the future, for those who truly wish to customize their experience to that extra degree, hang tight. Custom domains are on the horizon, being methodically rigged and tested even as we speak. This is yet another tool in your arsenal to connect with and engage your users, enabling you to continue building the most impressive applications.
Your PocketBase instance managed by PocketHost is accessible in two ways:
1. `<uuid>.pockethost.io`

18
packages/www/content/docs/usage/backup-and-restore.md
View File

@ -1,9 +1,25 @@
---
title: Backup & Restore
category: usage
description: Backup and restore your PocketHost instance.
description: Learn how to perform backup and restore operations for your
PocketHost projects using FTP. This guide provides step-by-step instructions
on how to ensure data safety and continuity for your PocketBase instances by
backing up and restoring your work efficiently. Empower your projects with
robust data management best practices.
---
# Overview
In the digital realm, safeguarding data is paramount. Therefore, knowing how to efficiently backup and restore your data is a crucial facet for any developer or enterprise owner. This guide focuses on those working with PocketHost projects, detailing how you can use File Transfer Protocol (FTP) to perform these operations with ease, thereby ensuring the safety and continuity of your PocketBase instances.
Before delving into the process, it’s important to ascertain the status of your PocketHost instance. Ideally, you’d want it in an idle state, a detail expanded upon in our instances usage document. Having your instance idle optimizes the process and reduces the risk of data conflicts.
Backing up is the first line of defense against loss of data or unforeseen errors. However, a backup is useless without knowing how to restore it correctly. It's a good practice to regularly test restoring from your backups to ensure they'd work correctly if the need arises.
Additionally, effective data management isn't only about ensuring the safe storage and retrieval of data. It also involves synchronizing data between different environments or platforms. The guide will provide some insights on how you can automate this process using lftp, based on a brilliant Stack Overflow article we found.
You can use [FTP](/docs/usage/ftp/) to perform backup and restore operations.
## Before you Begin

14
packages/www/content/docs/usage/create.md
View File

@ -1,9 +1,21 @@
---
title: Creating an Instance
category: usage
description: How to create a new PocketHost instance.
description: Learn how to create a new PocketBase instance on pockethost.io. A
unique name is all you need for your subdomain to get your backend running.
Experience the ease of having a deployment service do all the work for you.
---
# Overview
You've made it here, which tells me you're ready to plunge into the exciting world of virtually effortless backend deployment, thanks to PocketHost. First off, I want to put emphasis on just how simple and swift this process is. It's almost as easy as installing a NPM package.
To kick things off, every instance of PocketHost is given its own unique subdomain. To create a new instance, you'll need to navigate to [https://app.pockethost.io/app/new](https://app.pockethost.io/app/new). This brings you to the heart of the action. Here is where you get to choose a unique name for your subdomain, which is the identifier for your PocketBase instance.
And just like that, you're in the game! Once you've nailed down your subdomain, the rest takes care of itself. Behind the scenes, PocketHost is busy threading all the virtual cables together to bring your distinct backend to life. More importantly, it's quick– almost like creating a new git branch. Awaiting you upon completion is a fresh and ready-to-go PocketBase instance, accessible via your very own, uniquely named subdomain.
So, in essence, this is backend setup without breaking a sweat, without dealing with Linux administration, Docker containers, Domain management and whatnot. It's letting PocketHost do what it's meant to do. That’s it, you’re ready to connect to your fresh instance from anywhere and start building your application. Now go out there and create something amazing!
Every PocketHost instance runs on a unique subdomain. To create a new instance, head to [https://app.pockethost.io/app/new](https://app.pockethost.io/app/new).
You'll need to choose a unique name.

17
packages/www/content/docs/usage/ftp.md
View File

@ -1,9 +1,24 @@
---
title: FTP Access
category: usage
description: Accessing your PocketBase files via FTP
description: Discover how to access your PocketBase files via Secure FTP (FTPS)
on PocketHost. Learn how to navigate through different directories and
understand their purposes. Explore our recommended GUI and CLI clients to
further enhance the management of your PocketBase project online.
---
# Overview
In PocketHost, we believe in providing you with utmost control over your PocketBase instance. That's why we offer you access to all your PocketBase files via Secure FTP (FTPS). Simply head over to [ftp://pockethost.io](ftp://pockethost.io), pop in your pockethost.io account credentials and voila! You're in.
Upon logging in, you'll find a directory for each instance attached to your account. Within each of these instance directories, several subdirectories exist serving different purposes. The 'pb_data' directory, for instance, is the dedicated space for all PocketBase data. If you need to oversee public files, ensure to check out the 'pb_public' directory.
For a smoother navigation experience, we recommend a couple of Powerful FTP clients. FileZilla shines as a comprehensive GUI frontend for all platforms. For terminal lovers, widely known command-line tools such as 'ftp', 'wget', or 'lftp' will serve perfectly. Remember, the right tool can boost your ability to manage your PocketBase project online promptly and efficiently.
In PocketHost, you can be sure that we've taken that Linux administration load off your shoulders so that you can hone in on what truly matters - your code.
PocketHost allows you to access all your PocketBase files via Secure FTP (FTPS).
## Accessing via FTP

17
packages/www/content/docs/usage/hooks.md
View File

@ -1,9 +1,23 @@
---
title: PocketBase Hooks
category: usage
description: The prebuilt PocketBase v0.17+ executable comes with an embedded ES5 JavaScript engine (goja) which enables you to write custom server-side code using plain JavaScript.
description: Learn how to use PocketBase Hooks on PocketHost to write custom
server-side code using plain JavaScript. Enhance your app's functionality by
creating HTTP routes, updating/creating records, or running server actions
upon user registration. It's an essential guide for nodejs developers looking
to maximize PocketHost's potential.
---
# Overview
Currently, we're diving into the wonders of PocketBase Hooks on PocketHost. As a seasoned Node.js developer, you have the power to create dynamic server-side functionalities with minimal fuss. PocketBase Hooks let you write plain JavaScript code, incorporated into your PocketHost deployment, to create custom HTTP routes, update and create records, or even perform server actions when a user registers.
This is done within the `pb_hooks` directory, where every instance on PocketHost is mounted. We commonly see `*.pb.js` files placed in this directory, automatically executed once loaded into PocketBase. Some caveats to keep in mind - alterations in your `pb_hooks` directory will cause your PocketHost instance to restart and automatically escalate your changes.
If you're a fan of practical learning, take a look at some sample codes like an `onAfterBootstrap` event listener, registering new HTTP routes, creating and updating records, and even paying attention to collection changes. These scripts make it feasible to run server-side tasks, enhancing the versatility of your application. Remember, all these scripts go straight into your `pb_hooks` directory on the PocketHost instance. In a nutshell, this crucial guide increases the potency of PocketHost for any Node.js developers out there. Watch this space for more power-packed PocketHost functionalities. Keep coding, and as always, enjoy the journey!
The prebuilt PocketBase v0.17+ executable comes with an embedded ES5 JavaScript engine (goja) which enables you to write custom server-side code using plain JavaScript.
Every PocketHost instance comes with a `pb_hooks` directory which is mounted into the PocketBase instance at `/pb_hooks`. This directory is where you can place your custom server-side code.
@ -134,7 +148,6 @@ routerAdd('POST', '/posts', (c) => {
// Create a new post record
const record = new Record(postsCollection, {
title: postTitle,
description: postDescription,
})
// Save the record

22
packages/www/content/docs/usage/instances/index.md
View File

@ -2,9 +2,27 @@
title: Instance Details
category: usage
subcategory: instances
description: Details about PocketHost instances
description: Learn how to manage your PocketHost instance with our comprehensive
guide, covering on-demand execution, usage metering, versioning, secrets, and
admin access. Master the nuances of using PocketHost and get your PocketBase
projects up and running in no time. Essential reading for web & node.js
developers.
---
# Overview
Dive straight into managing your individual PocketHost instances via an easy-to-use dashboard. Each PocketBase deployment functions on an on-demand basis, launching only upon receiving a web request. Following a period of 5 seconds idle time, instances hibernate for optimal hardware use, with a negligible latency during the "first hit".
Track usage through PocketHost’s integrated metering system, offering a generous 100 active minutes each month in the free tier. When over this limit, you have the option to purchase extended usage, or to shift your instance to the pool of stand-by instances.
Control the your PocketBase version deployed with each instance. Default selections utilize the latest major+minor release, locked at instance creation. Upgrades to successive versions can be facilitated by reaching out to support.
Administer your instance efficiently with the use of instance-specific access, available at the URL https://<instance-name>.pockethost.io/_. This can also be accessed via the PocketHost dashboard.
Secure your instance with environment variables unveiled at `pocketbase` executable launch. Secrets are accessible as environment variables, available to the `pocketbase` process. Monitor developments through the realtime log – a feature to be launched soon.
PocketHost provides a simple dashboard where you can manage your instance.
## On-demand Execution
@ -58,4 +76,4 @@ $app.getEnv('FOO')
## Realtime log
Coming Soon
Coming Soon

22
packages/www/content/docs/usage/maintenance.md
View File

@ -1,9 +1,27 @@
---
title: Maintenance Mode
category: usage
description: Maintenance Mode will prevent your instances pocketbase process from running. No requests are processed while your instance is in Maintenance Mode.
description: Discover how to utilize Maintenance Mode on PocketHost, a vital
tool for managing PocketBase instances. Perfect for carrying out updates, data
backups, or emergency shutdowns, Maintenance Mode ensures no unwanted requests
are processed, prioritizing control and system health. Learn about manual
activation and automatic triggers in this walkthrough.
---
# Overview
Step into the shoes of system administrator with PocketHost's Maintenance Mode. This is an essential tool when managing PocketBase instances, providing a reliable lifeline during updates, data backups, or emergency shutdowns. It ensures zero unwanted requests are processed when your PocketBase instance requires focus on control and system health.
In the unpredictable world of software, instances can sometimes malfunction. When this occurs, PocketHost reacts by automatically activating Maintenance Mode. This action triggers an immediate shutdown of your PocketBase instance, terminating the `pocketbase` process and halting further requests.
Taking the driver's seat, you can also manually engage Maintenance Mode. During crucial tasks such as version updates, data backup and restoration, and even emergency shutdowns, you have the power to control the flow of requests.
To manually activate Maintenance Mode, steer yourself to your instance dashboard. Venture to the bottom of the page to find the "Danger Zone". Now, flip the switch to Maintenance Mode. It's as simple as that. With PocketHost in your toolkit, you'll always have total command when it comes to orchestrating your back end infrastructure.
Don't forget that these topics are further elaborated in their individual chapters - [Upgrading](/docs/usage/upgrading/) and [Backing up and Restoring](/docs/usage/backup-and-restore/).
Maintenance Mode will prevent your instances `pocketbase` process from running. No requests are processed while your instance is in Maintenance Mode.
Maintenance mode can be activated manually, or PocketHost may place your instance in maintenance mode if it detects that the instance is malfunctioning.
@ -22,4 +40,4 @@ To activate Maintenance Mode, navigate to your instance dashboard and scroll to
Then, switch the instance to Maintenance Mode.
![Maintenance Mode](/docs/maintenance-mode-screenshot.png)
![Maintenance Mode](/docs/maintenance-mode-screenshot.png)

15
packages/www/content/docs/usage/rename-instance.md
View File

@ -1,9 +1,22 @@
---
title: Renaming an Instance
category: usage
description: The subdomain name is unique across all of PocketHost, but you can change it. When you change it, you relinquish the old name and someone else can grab it if they want it.
description: Learn how to rename your PocketHost instance and its implications.
Unique, user-friendly subdomains make accessing your projects convenient, but
a name change relinquishes your old subdomain and allows others to claim it.
Remember, handle your subdomains with care.
---
# Overview
Accessing your PocketHost instances through their permalink, like `https://mfsicdp6ia1zpiu.pockethost.io`, is always possible. Yet, for convenience and ease of use, you can utilize a more user-friendly unique subdomain such as `https://harvest.pockethost.io`.
When it comes to renaming your applicable subdomain, tread cautiously. The renaming process releases your old name back into the pool, open for anyone to claim. This can be critical in case you decide to return to your previous moniker, or if your project has a strong connection to its original subdomain.
To maintain your digital property rights, be thoughtful about your renaming decisions. Avoid frequent name changes, especially if the subdomain name is associated with any existing functionality or references. Remember, your subdomain represents your project's digital address, making it a vital component of your brand identity. Handle it with care to prevent any undesired eventualities or reclamation by other users.
In summary, while PocketHost offers the flexibility to rename your instances, it comes with implications. Plan carefully and make sure you won't regret relinquishing your old subdomain before you decide to make a change. Your subdomain is much more than a name; it's a cornerstone of your project’s identity and accessibility.
PocketHost instances can always be accessed by their permalink, such as `https://mfsicdp6ia1zpiu.pockethost.io`, but they can also be accessed by convenient subdomain such as `https://harvest.pockethost.io`.
The subdomain name is unique across all of PocketHost, but you can change it. When you change it, you relinquish the old name and someone else can grab it if they want it. So be careful.

20
packages/www/content/docs/usage/upgrading.md
View File

@ -1,9 +1,27 @@
---
title: Upgrading your Instance Version
category: usage
description: How to upgrade your PocketHost instance to a new version of PocketBase
description: Learn how to upgrade your PocketHost instance version quickly and
securely. Be it an automatic upgrade for minor updates or a manual upgrade for
rarer and more substantial updates, our guide makes the process
straightforward while prioritizing your project's data safety. Upgrade, but
don't compromise.
---
# Overview
Unlock the full potential of PocketHost by upgrading your instance version promptly and effortlessly. PocketHost's comprehensive support for all versions of PocketBase grants you the power to optimize your instance with the latest and most capable versions out there.
To upgrade your instance, take advantage of the Danger Zone in the instance details. Specify the desired PocketBase version using semver format. This upgrade can be automatic for minor updates or manual for more substantial changes.
Always initiate the upgrade process by backing up your instance for data integrity. In most scenarios, automatic upgrades are advised. Simply change to the new version you want. While specifying a semver range like `~0.16.0`, the system will embrace any upcoming patch release without including major versions. After this step, you can take your instance out of maintenance to make it live.
In some exceptional cases, resort to manual upgrades. These steps require downloading your database via FTP, performing necessary upgrades according to PocketBase documentation, and re-uploading the database. After exiting maintenance mode, ensure to test your instance.
Upgrading your PocketHost instance means staying ahead and leveraging the best features it offers. But always emphasize protecting your project's data without compromising utility.
PocketHost supports all versions of PocketBase.
Your instance uses [semver](https://semver.org/) version (`0.16.0`) or semver range (`~0.16.0`) to describe which version of PocketBase to run.