Skip to content

Getting Started

Welcome to Pubky! You’ll create your identity, sign in to pubky.app, and inspect the data you publish.

Step 1: Download Pubky Ring

Section titled “Step 1: Download Pubky Ring”

Pubky Ring is your key manager for the Pubky ecosystem. It stores your identity and lets you authorize Pubky apps without creating a platform-owned account.

Official Website · Official Repository

Step 2: Create Your Pubky Identity And Profile

Section titled “Step 2: Create Your Pubky Identity And Profile”
  1. Visit pubky.app.
  2. Click “Join now”.
  3. Enter your invite code if you have one. If not, depending on where you are located, you may be able to use SMS verification and/or Bitcoin payment verification. These checks help Homeserver operators prevent signup spam. They are not meant to invade your privacy or charge you for using the Homeserver. Other signup methods are in development.
  4. Scan the QR code with your smartphone and open the link with Pubky Ring. The QR code contains your invite code.
  5. Authorize pubky.app in Pubky Ring to write to /pub/pubky.app on your Homeserver. Homeservers only allow an app to write to the paths you approve. As of today, everything under /pub/ is public by default, so read access does not require authorization.
  6. Create your Pubky profile.
  7. Save your recovery phrase securely - this is your master backup.
  8. Your public key (pubky) is now your permanent identity!

Your pubky looks like this:

z4e8s17cou9qmuwen8p1556jzhf1wktmzo6ijsfnri9c4hnrdfty

Step 3: Try pubky.app

Section titled “Step 3: Try pubky.app”

Once your profile is created, use pubky.app as a decentralized social media app built on Pubky.

  1. Start posting, following, tagging, and exploring.
  2. Reopen pubky.app later and sign in with the same Pubky Ring identity.

What makes it different:

  • You define on which Homeserver your own data is stored. You are in control.
  • Your feed is shaped by your choices, not by a platform’s engagement algorithm.
  • Pubky is designed for censorship resistance and credible exit.

Explore Other Pubky Apps

Section titled “Explore Other Pubky Apps”

Your Pubky Ring identity can be used across different Pubky apps. When you authorize another app, it can publish data on your Homeserver, instead of making you create a separate account for every application. As you sign in to these apps, notice how Pubky Ring asks you to approve access to specific paths on your Homeserver.

  • mypubky: A shareable bio page for your profile, links, posts, and payment options.
  • Payky: A payment profile for sharing your payment details, from crypto to fiat, in one link.
  • Mapky: A social map where your location-based data stays user-owned.
  • Eventky: A social calendar and event management app with event data stored on each user’s Homeserver.

Step 4: Explore Your Data

Section titled “Step 4: Explore Your Data”

Use Pubky Explorer (explorer.pubky.app) to browse your data.

  1. Enter your pubky or navigate to a path.
  2. Browse your files and directories.
  3. See exactly what data you have published.
  4. Share direct links to your public data.

Example paths:

  • pubky://your-key/pub/pubky.app/profile.json - Your profile
  • pubky://your-key/pub/pubky.app/posts/ - Your posts directory

Next Steps

Section titled “Next Steps”

Common First Questions

Section titled “Common First Questions”

Do I need Pubky Ring to use Pubky?

Pubky Ring is the recommended way to manage your identity and authorize apps. It keeps your key material separate from individual apps.

Can I use Pubky without running my own Homeserver?

Yes. Users can choose a public Homeserver provider. Running your own is optional.

Where is my data stored?

Your public app data is stored on a Homeserver, which is linked to your pubky through PKARR. You can change your Homeserver in Pubky Ring, and Pubky Explorer lets you inspect what is currently stored there.

Resources

Section titled “Resources”