> ## 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. # Web installer > Install MagicPost from your browser: what each step checks, what it writes, and how to sign in for the first time. The installer lives at `/install`. It checks your server, saves the database connection, creates the tables, activates your license and creates the first admin account. ## Before you start **1. Upload the files** Upload the application to your server, including hidden files such as `.env` and `.htaccess`. If you copy files from your computer, turn on hidden files in your file manager or FTP client first, otherwise these files are skipped. See [Manual and .env setup](https://magic-post.mintlify.site/installation/manual-setup.md) for the document root options. **2. Create a database** Create an empty MySQL database and a user that has full rights on it. Note the database name, user and password. **3. Have your license details ready** You need the license key (the Envato purchase code) and the Envato username of the buyer. If you cannot find the code, see [Where is my purchase code](https://help.market.envato.com/hc/en-us/articles/202822600-Where-Is-My-Purchase-Code-). **4. Check requirements** Confirm the server meets the [requirements](https://magic-post.mintlify.site/getting-started/requirements.md). ## Run the installer **1. Welcome** Open `https://YOUR_DOMAIN/install` in your browser and click **Start Installation**. A progress bar across the top shows the six steps: Welcome, Requirements, Permissions, Database, Activation and Complete. **2. Requirements** The **Server Requirements** page lists the PHP version against `8.3+`, each required PHP extension, the Apache modules (when PHP can report them) and the **Functions** group, which is marked **Optional**. A **Security** note appears if `session.upload_progress.enabled` is on. Fix anything marked as failed, then click **Next**. > [!WARNING] > > **Next** is always available. The installer does not stop you when a check fails, so fix failed items first. **3. Permissions** The **Permissions** page tests that PHP can write to the `.env` file (listed under **Files**) and to the folders listed under **Folders**: `bootstrap/cache`, `public/uploads`, `lang`, `storage` and the `storage/framework` and `storage/logs` subfolders. Fix the permissions of any item marked as not writable, then click **Next**. **4. Database** On **Database Configuration**, fill in the connection details and click **Next**: | Field | Value | | - | - | | **Hostname** | `localhost`, unless your host gave you another database server | | **Port** | `3306`, unless your host gave you another port | | **Database Name** | The database you created | | **Database User** | The user with rights on that database | | **Database Password** | The user's password | MagicPost connects to the database to test the details. If the test passes, it writes `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME` and `DB_PASSWORD` into `.env`. If it fails, you stay on the page with the error. **5. Activation** Opening this page first builds the database: it runs the migrations and the seeders, and then sets `SESSION_DRIVER=database` in `.env`. This can take a little while, so wait for the page to load and do not reload it. When the **License Activation** form appears, enter the **License Key** and the **Envato Username**, then click **Activate**. Both fields are required. **6. Complete** After the license server accepts the key, MagicPost creates the admin account, writes the `.lic` file and the `storage/installed` marker, and saves the license details. The **Installation Complete** page confirms **Application Successfully Activated**, shows the default admin login, and shows the cron command with a **Copy** button. Click **Finish Installation** to open your site. ## First sign-in Open `https://YOUR_DOMAIN/login` and sign in with the default admin account: | Field | Value | | - | - | | Email | `admin@example.com` | | Password | `admin12345` | You land on the admin dashboard. > [!WARNING] > > These credentials are the same on every install. Change the email and password straight away: open your account menu at the bottom of the sidebar, then **Profile** for the email and **Security → Password** for the password. ## What the installer changes * Creates all database tables and seeds the roles `user`, `subscriber` and `admin`, the payment gateway list, the AI model lists, the provider key rows and the finance settings. * Writes the database connection and `SESSION_DRIVER` in `.env`. * Stores the license key, username and license type in General Settings, and writes the license response to the `.lic` file in the application root. * Creates the admin user named **Admin** with a verified email and the `admin` role. * Creates `storage/installed`. While that file exists, `/install` redirects to the login page, so the installer cannot be run a second time by accident. ## Troubleshooting > [accordion] Invalid database credentials, or the user has no access to the database > > The message includes the database error. Check the hostname and port, that the user and database names are exactly as created (some hosts add an account prefix), and that the user has rights on that database. > [accordion] Failed to migrate the database, or Failed to seed the database > > The message ends with the cause. A common one is a database user that cannot create tables. Fix it, then open the Activation step again, because it runs the migration and the seeders each time it loads. > [accordion] There was an error while activating your application > > The license server rejected the details or could not be reached. Check the key for stray spaces and the Envato username, and confirm that your server allows outbound HTTPS requests through `curl`. Then click **Activate** again. > [accordion] Failed to create the default admin, or Failed to finalize the installation > > The message ends with the underlying error. For the second message, PHP could not write `storage/installed`, so check the permissions of the `storage` folder. > [accordion] /install sends me to the login page > > The `storage/installed` file exists, so the installation is already finished. Sign in instead. For more fixes, see [Installation problems](https://magic-post.mintlify.site/troubleshooting/installation.md). ## Next > [card] [Add the cron job](https://magic-post.mintlify.site/installation/cron-and-queue.md) > > Required before any scheduled post goes out. > [card] [Post-install checklist](https://magic-post.mintlify.site/installation/post-install-checklist.md) > > The ordered first-day tasks. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.