---
path: /docs/start
title: Getting started with Aloha Social
description: The good guide for your first day: an account, a first post, the people you want to follow, and the few settings worth changing straight away.
group: start
---

# Getting started with Aloha Social

Everything on this page happens in the Aloha Social app inside your workspace. If your organisation has not set up Aloha Social yet, the [installation guide](/install) is the page to send your administrator — it takes about ten minutes.

## Before you start

You need an Aloha account on a server that runs Aloha Social. That is the whole requirement: the same login, the same password, the same two-factor authentication you already use for files, calendar and chat. There is no second account to create and no separate password to remember.

Open the app menu in Aloha and choose **Aloha Social**. The first screen asks whether you want a fediverse identity here. Nothing is created until you answer.

## Step 1 — Pick your handle

Your address will be `@handle@your.cloud`. The handle is suggested from your user name and accepts letters, digits, underscore, dot and dash.

Pick it carefully: **the handle cannot be changed later.** Your display name and avatar come from your Aloha account and can be changed there whenever you like.

Where the administrator allows open registration, the login page also has a **Create an account** button for people who are not Aloha users yet. Such an account is for Aloha Social only.

## Step 2 — Take the four-step introduction

On your first visit the app shows four short screens:

1. your address, with a copy button for it;
2. people to follow;
3. a way to bring the follows you already have from another server;
4. a button that puts you in the composer.

Every step can be skipped. Once closed it stays closed, and **Settings → Help → Introduction** shows it again.

## Step 3 — Follow a handful of people

A timeline with nobody in it tells you nothing. The introduction offers a starting set, and [Discover](/docs/user-finding-and-following-people) searches across several fediverse directories at once — the results name which directory answered, so a short list is never mistaken for an empty fediverse.

Three things worth knowing:

- **Starter packs** follow a whole named group of accounts with one click. Your administrator curates the ones for this server.
- **Colleagues are suggested** from the workspace you share, so the people you already work with are the first results.
- **Followed hashtags** work like a subscription: follow `#photography` and those posts arrive in your timeline without anybody following anybody.

## Step 4 — Write your first post

Open the composer and write. The four things worth deciding on that first post:

| Decision | What it does |
|---|---|
| **Audience** | Public, unlisted, followers-only or direct. A reply inherits the audience of the post it answers. |
| **Content warning** | Collapses the post behind a line of your choosing. |
| **Alt text** | The composer asks before a picture without a description goes out. A nudge, never a refusal. |
| **Language** | Labels the post so readers and translation know what to expect. |

Anything up to 120 characters can go out drawn big on colour as a short text post. Pictures, video, polls, files and scheduled posts all live behind the same toolbar — see the [Write feature page](/features/write).

## Step 5 — Change these four settings

Everything works with the defaults, but these four are worth two minutes:

1. **Settings → Appearance** — light, dark, or follow your device. The dark design is the same design, not an afterthought.
2. **Settings → Notifications → Who may reach you** — five questions, each answered *Allow* or *Hold for review*. New accounts start with the calm policy: strangers and brand-new accounts wait quietly instead of ringing the bell.
3. **Settings → Filters** — add the words you would rather not see. Filters fold matching posts behind the filter's name or take them out altogether.
4. **Settings → For you** — the optional ranked feed. Recommendations explain why they appear; behavioral learning has its own consent control, and learned data is account-scoped and not federated.

## Where to go next

- [The full user guide](/docs/user) — posting, reading, following, filtering and your account, topic by topic.
- [Keyboard shortcuts](/docs/user-keyboard-shortcuts) — `j`, `k`, `l`, `f`, `b`, and `?` for the whole list.
- [Moving an account](/docs/moving) — bringing your posts and follows from another server.
- [Apps and downloads](/clients) — the web app today, and the apps for iPhone, Android and desktop.
