Skip to content
join invite connect getting-started first-time profile identity

Join a Server

Connect to an Orbitr server and start chatting in under 2 minutes.

beginner ⏱ 2 min 🚀 Getting Started Updated 2026-06-24

Someone invited you to their Orbitr server? Here’s how to get in.

What You’ll Need

  • The server address (URL) from whoever invited you. It looks something like chat.example.com or 203.0.113.45
  • An invite link if the server is invite-only (most are)
  • The Orbitr app, which you can download here
🤔 What's an Orbitr server?

Orbitr is self-hosted. Each community runs on someone’s own hardware instead of a central service. When you join a server, you’re connecting directly to that person’s machine. Your messages stay on their server, not ours.

Connect to the Server

1

Open the Orbitr App

If you don’t have it yet, grab the Orbitr app from the download page.

When you first open the app, you’ll see the Connect to a Server screen. If you’ve already connected to other servers, click the + button in the server sidebar.

Orbitr Connect to a Server screen
The first thing you see when you open the app.
2

Enter the Server Address

Type or paste the server address into the input field and click Connect.

ℹ️ HTTPS is automatic

If you enter a plain domain like chat.example.com, the app automatically tries HTTPS first. You don’t need to type https:// unless the address uses a non-standard port.

The app will connect and show you the server’s sign-in screen.

3

Create Your Account

If this is your first time on this server, you’ll create a new account:

  1. Choose a username and password
  2. Set up your profile (display name, avatar)

If the server is invite-only, you’ll need to enter or click the invite link the server admin shared with you.

Create identity screen with username and password fields
Pick a username and password. Your identity is generated locally.
âš™ How your identity works

Orbitr uses local-first identity. Your identity lives on your device as a single master key that never leaves it. For each server you join, the app derives a separate key scoped to that server, so every server sees a different fingerprint. Because the keys differ, two servers can’t prove you’re the same person from your identity alone — even if they compare notes. You authenticate by signing a one-time challenge with your key; no password is ever sent to the server. Your display name and avatar travel with your identity, but you can set a different nickname and avatar in each community — handy if you want to stay separate, since a reused name or avatar can still give you away.

4

You’re In

Once signed in, you’ll see the server’s orbits (communities) and channels. Jump into a channel and start chatting.

If you don’t see any orbits yet, the server admin may need to invite you to one, or you can create your own if the server allows it.

Orbitr chat interface: channel sidebar, messages, and member list
You're in. Jump into any channel and start chatting.

Troubleshooting

”Connection failed” or timeout
  • Double-check the server address for typos
  • Make sure the server is online. Ask the person who invited you
  • If the address is an IP with a non-standard port (like 192.168.1.50:4113), make sure you include the port
  • Try adding http:// or https:// explicitly
”Invite required” error

The server is set to invite-only. Ask the server admin for an invite link. Paste it in your browser. It will open the Orbitr app and register you automatically.

Can’t connect from outside the local network

If the server is running on someone’s home network, they may need to set up port forwarding or a tunnel. Point them to the Custom Domain Setup guide or Public Access guide.

What's next?

Set Up Your Server

Orbitr PulsarOptional

Optional cloud identity backup and sync, so your identity follows you across devices.

Visit Orbitr Pulsar