Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Your first site, step by step

From an empty directory to a running site you can edit, in ten steps - get the code, install, serve it with Velocity, sign in, add content, change a template and check the result.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/creators/website-creators/your-first-site-step-by-step.md

On this page

Your first site, step by step

This page is for website creators who want a running site on their own machine to learn on. It takes you from an empty directory to a site with your own content and one changed template. Each step ends with something you can check. It uses the defaults on purpose: SQLite (no database server), the default site package and Velocity. For a real site, read Choosing an install method afterwards.

The help center in the administration, where this page and the rest of the website creators' path are
The help center in the administration, where this page and the rest of the website creators' path are

Contents

  1. Before you start
  2. Steps 1-3: code, install, serve
  3. Steps 4-6: sign in and add content
  4. Steps 7-9: change how a page looks
  5. Step 10: look around
  6. If something does not work

Before you start

You need PHP 8.0 or newer (PHP 7.4 usable without support) on the command line, Composer 2 and Git (Requirements). Run every command from the installation root, the directory that holds index.php, as your own user (not root).

Steps 1-3: code, install, serve

Step 1. Get the code (Getting the code):

git clone https://github.com/se7enxweb/exponential.git mysite
cd mysite
composer install

Check: ls index.php kernel settings lists all three.

Step 2. Install. With no options, exp:install installs the sevenx_multisite package on SQLite with the administrator admin and a generated password (The console install):

php bin/php/console exp:install --apply --url=http://127.0.0.1:8088

Check: the summary at the end says "Exponential is installed" and shows the password once. Write it down; it is also in var/log/initial-admin-password (readable only by you) until you delete that file.

Step 3. Serve it. Install the Velocity engine and start it (8.3 Exponential Velocity):

composer require se7enxweb/exponential-velocity
php bin/php/console exp:velocity config set --apply ServerSettings Engine qbix
php bin/php/console exp:velocity start
php bin/php/console exp:velocity status

Check: status lists the addresses; curl -sI http://127.0.0.1:8088/ | head -1 prints 200 or a redirect.

Tip

No Velocity yet? php bin/php/console exp:velocity start --engine=php uses PHP's built-in server, which is enough to look around (port 8087, development only).

Steps 4-6: sign in and add content

Step 4. Open the site at the Site: address the install printed. You see the demo front page.

Step 5. Sign in at the Admin login: address with admin and the password, then change the password (My account; see Accounts and sign-in). Delete var/log/initial-admin-password afterwards.

Step 6. Create content. In the administration, open the content structure, choose a folder, pick Article in the create menu, fill in the title and body and press Send for publishing (Editing content). Check: the article appears in the folder's sub-items and on the site.

Steps 7-9: change how a page looks

Step 7. Find the design. Ask which design the public siteaccess uses:

php bin/php/console exp:ini where site/DesignSettings/SiteDesign site

The last line, In effect, names the design (Templates and design).

Step 8. Override the article's template for this one article, with the click path: Design > Template Editor, open node/view/full.tpl, press New override, choose Default copy, give the article's object ID and create it. Add a line such as <p>My first override</p> and save. Details: Template overrides for site builders.

Step 9. Check. Reload the article on the site: your line is there. Remove the override again from the same list when you are done.

Step 10: look around

  • The help (/exphelp/dashboard in the administration) has pages for editors and administrators; your editors will start there.
  • Setup > System information shows the PHP, database and extensions in use (System information).
  • The layouts editor builds landing pages without templates (Landing pages with the layouts editor).

If something does not work

You seeDo
composer install refuses your PHPinstall PHP 8.0 or newer (PHP 7.4 usable without support) (2.2 PHP)
The install stops in SystemCheckread the printed fix; usually a missing PHP extension or permission
A maintenance page instead of the sitephp bin/php/maintenance.php status, then off
Errors about files that cannot be writtenyou ran a command as root; see 12. Troubleshooting
Anything elseWhen something goes wrong

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x