When the development server is running, you can visit the setup tool using http://your-server-base-url/setup. This guide explains the different steps of the Setup Tool.
After you have installed Neos for the first time locally, you will be prompted to visit http://your-server-base-url/setup.
Typically it will be: http://127.0.0.1:8081/setup
A check for the basic requirements of Flow and Neos will be run. If all is well, you will see a login screen. If a check failed, hints on solving the issue will be shown and you should fix what needs to be fixed. Then just reload the page, until all requirements are met.
Click "Go to setup" to proceed
Due to an unfinished setup, the technical Information will typically show some errors, that can be ignored.
After you hit "Go to setup" the Neos Setup will initialise for the first time.
The login screen will tell you the location of a file with a generated password. Keep that password in some secure place, the generated file will be removed upon login! It is possible to have a new password generated if you lost it.
- Look for the SetupPassword.txt file which contains your setup password
- Paste the password
- Click "login" to proceed
Neos now checks, if an image manipulation software is installed that can be used. It will also automatically select the best option for you.
Click "Next" to proceed
The next step is all about the used database. In our example we use MySQL.
Fill in the database credentials.
utf8_unicode_cicollation by default if possible!
If the connection was established successfully, the info box will be updated and shows accessible databases to choose from, or you can create a new one.
In most cases it is useful to create a new database, choose a name and proceed with "Next".
This step creates an initial user with administrator privileges.
Enter your prefered credentials and proceed with "Next".
One last step, before you can start:
- Import a Site from existing site package (e.g. Neos Demo Package)
- Create a new Site Package with a "dummy" Site
Use the provided Neos.Demo site package, if you want to try Neos and have a basic styling of all the provided NodeTypes like Headline, Text, Image and so forth.
Create a new site package, if you want to start a clean install of Neos (without any CSS), creating a new site package is for you.
Dummy/Empty Site Package
If you start with a clean site package, you will see some basic NodeTypes like Columns, YouTube, Headline, Text, Image, etc. But they will have no styling and will throw an exception in the Neos backend.
Neos only provides building blocks and wants to give you full control over the complete styling of those elements. So there is no default CSS provided.
Why not add some basic CSS styling?
It is not an easy task to solve. If some basic CSS would be added, it would be a breaking change for people that expect it not to be there. Additionally those elements would probably not be really best practice.
If you want basic styling, the demo site is for you. Nevertheless, our best practice usually suggests to build elements from scratch (with the help of existing mixins for example) to have full control.