> ## Documentation Index
> Fetch the complete documentation index at: https://magic-post.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Go from an empty server to your first published post, in the order an owner does it.

This page follows the shortest path from upload to a live post. Each step links to the page with the full detail.

**1. Check your hosting**

Confirm PHP 8.3 or newer, MySQL and the required extensions. See [Requirements](https://magic-post.mintlify.site/getting-started/requirements.md).

**2. Run the web installer**

Open `https://YOUR_DOMAIN/install`, follow the six steps, and enter your license key and Envato username when asked. The final screen shows the default admin login and the cron command. See [Web installer](https://magic-post.mintlify.site/installation/web-installer.md).

**3. Add the cron job**

Create a cron job that runs every minute and paste the command from the installer's last screen. Nothing is published until it runs. See [Cron and queue](https://magic-post.mintlify.site/installation/cron-and-queue.md).

**4. Sign in and secure the admin account**

Open `https://YOUR_DOMAIN/login` and sign in with the default admin account. Then change the email and password right away: open your account menu at the bottom of the sidebar, choose **Profile** to change the email, and **Security → Password** to change the password.

**5. Register one network**

Pick the network you want to test first and create a developer app for it by following its page under [Publishing channels](https://magic-post.mintlify.site/channels/overview.md). Then in the admin sidebar open **Publishing → Platforms** and do the following:

1. Click **Add credentials** on the network's card.
2. Copy the redirect URI shown under **What to register** and add it to the developer app.
3. Paste the app's ID and secret into the form.
4. Tick **Available to users** and click **Save**.
5. Click **Run checks** to confirm the credentials work.

The card changes to **Live** once the network is configured and enabled.

**6. Connect a channel**

In the sidebar open **Channels**, click **Add a channel**, choose the network and authorise MagicPost. You return to the **Channels** page with the new channel listed under **Connected accounts**. If the authorisation covers several accounts, pick the ones you want and click **Connect**.

**7. Publish a post**

Open **Composer**, choose the channel, type a caption under **Caption** and click **Publish now**. Confirm in the dialog that opens. To test the scheduler as well, open the **When** tab, choose **At a time**, set a time a few minutes ahead and click **Schedule** instead.

**8. Check the result**

Open **Posts** to see the post and its status. Then open **Publishing → Settings** in the admin sidebar: **System health** lists anything that still stops posts from going out, and reads **Ready to publish** when nothing does.

> [!TIP]
>
> Before you rely on a channel, open **Channels** and click **Check** on its card. Where the network allows it, the **Connection check** offers **Send a private test** so you can confirm posting works without publishing anything public.

> [!NOTE]
>
> Email verification, password resets and failed-post alerts need working mail. Configure SMTP under Platform → Backend Settings → SMTP Settings in the admin sidebar. While mail is only written to the log, **System health** reports **Email** as a warning.

## What to do next

> [card] [Post-install checklist](https://magic-post.mintlify.site/installation/post-install-checklist.md)
>
> The ordered first-day tasks for a new install.

> [card] [Composer](https://magic-post.mintlify.site/user-guide/composer.md)
>
> Per-channel captions, media, first comments and previews.

> [card] [Connect channels](https://magic-post.mintlify.site/user-guide/connect-channels.md)
>
> Health states, reconnecting and groups.

> [card] [Admin panel overview](https://magic-post.mintlify.site/admin/overview.md)
>
> Where every setting lives.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.