Installing AIODomain
Uploading the files, the .htaccess, the five-step wizard field by field, the cron job as a command line and as a web address, sub-folder installs, safety tips and an after-install checklist.
The install is five steps in a browser and one cron job. It takes about two minutes. This chapter covers uploading the files, the .htaccess, every field of the wizard, the cron job in both forms, a sub-folder install and a short checklist for afterwards.
Before the launch read the chapter Security and going live: the Health & Security Check page tests the real server and lists what to fix.
1. Upload the files
- Download the full package
AIODomain-<version>.zipfrom your account at lcpanel.com. Use the full package for a new installation. The other file,AIODomain-<version>-update.zip, is only for updating a working marketplace, see Updating. - Create the domain or sub-domain on your hosting (for example
market.example.com) and note its folder, for examplepublic_htmlormarket.example.com. - Upload the ZIP to that folder with the File Manager or FTP and Extract it. The files
index.php,install.php,.htaccess,admin/,site/,api/,includes/,cron/,themes/,plugins/and the rest must sit directly in the folder, not in a second folder inside it. - Check that the hidden file
.htaccesscame along. In the cPanel File Manager switch on Show Hidden Files (dotfiles) in Settings.
The ZIP never contains config.php, installed.lock, or any content of data/ and uploads/. The wizard and the first page view create them.
2. The .htaccess
The shipped .htaccess sends every request that is not a real file or folder to index.php, which is the one entry point of both the marketplace (/) and the admin area (/admin). It also:
- switches directory listings off;
- refuses web access to
includes,data,cron,admin/pages,admin/ajax,site/pages,site/ajax,languagesanddocs; - refuses
config.php,installed.lock,db_update_lib.php,CHANGELOG.mdandREADME.md; - refuses plugin code (the
assets/folder inside a plugin stays public); - refuses
uploads/attachmentsanduploads/kyc, where ticket attachments and identity documents live; - refuses
.json,.lock,.log,.sqland.mdfiles.
It needs Apache (or LiteSpeed) with mod_rewrite and AllowOverride enabled, which every cPanel host has. On nginx, add the same idea yourself: serve real files, deny the private folders above, and send everything else to index.php.
3. The wizard
Open https://your-domain/ or https://your-domain/install.php. Until the install is finished, the site address opens the wizard by itself. The five steps are shown at the top of the page.
| Step | What it does |
|---|---|
| 1. Requirements | Lists PHP 7.4+, the extensions (see Requirements), DNS lookups (dns_get_record) and the writable folders. Continue appears when everything required is green; otherwise fix it and press Check again. |
| 2. Database | Fields Host (default localhost), Port (3306), Database name, User, Password and Table prefix (default ad_; keep it unless the database is shared with another script). Save and continue connects to the server, creates the database if it is missing and writes config.php (the database settings, a random secret key, the licence server address and the product code). A wrong password or host shows Database: followed by the database's own message. |
| 3. Site & administrator | Marketplace name (default AIO Domain), Site URL (the address of this installation without a trailing slash; it is filled in for you), Contact e-mail, Country (default Bangladesh), Time zone (default Asia/Dhaka), Admin username (3 to 32 letters, digits, dots, dashes or underscores, starting with a letter), Admin password (at least 8 characters) and Admin password (again). Create and continue creates every table and fills in the starting data. |
| 4. Licence | Paste the Licence key and press Activate, or press Skip for now. The key is bound to the domain shown on the page. A refused key shows the License Center's message and you stay on this step. |
| 5. Done | Shows the admin address, the marketplace address and the cron line. |
If you close the browser half-way, open the site address again. When config.php exists the wizard goes on from step 3. Once step 5 is shown the install is finished and the wizard redirects to the admin area, so it can never run twice. You may delete install.php afterwards or leave it; it refuses to run again.
What step 3 puts in
- Defaults for every setting, including a random cron key.
- Four currencies: USD (the default), EUR, GBP and BDT.
- Seven staff roles: Super Administrator, Administrator, Moderator, Support Agent, Finance Manager, Content Manager and Domain Broker. Buyers and sellers are account types, not roles. See The admin tour.
- About 140 domain extensions (the 12 best known marked Popular), 22 categories and 16 registrars to choose from.
- Eight ticket categories and a help center with six topics and seven articles.
- Ten system pages (About Us, Terms of Service, Privacy Policy, Cookie Policy, Refund Policy, Domain Transfer Policy, Auction Rules, Buyer Protection, Seller Policy, Report Abuse) and ten FAQ entries.
- The 26 e-mail templates, ready to edit.
- Your administrator account, with the Super Administrator role, an e-mail address already marked as verified, a verified identity and the seller badge. It is also a normal member account of type Buyer & Seller, so you can try the marketplace with it.
The pages and the FAQ are sample text. They talk about secure payment, transfers and auctions, which are not in this release. Read and edit them on the first day.
4. Set up the cron job
AIODomain does its automatic work from one script that must run every 5 minutes: it works the mail queue, checks DNS records for pending verifications, expires and warns about listings, sends saved-search alerts, re-checks ownership, refreshes registry data and exchange rates, rebuilds the sitemap, closes answered tickets and cleans old rows. Hourly and daily jobs decide by themselves when they are due; the daily ones run once a day after the hour set in Settings → General Settings → System (default 3, in the site time zone).
Command line (cPanel Cron Jobs or a VPS crontab):
*/5 * * * * /usr/local/bin/php /home/USER/public_html/cron/cron.php >/dev/null 2>&1
Use the PHP path and the folder of your host. Settings → System & Maintenance shows the exact line for your installation in the Cron card, with a Copy button.
Web cron (when the host has no cron or only runs php-cgi): call this address every 5 minutes from any web cron service, or with curl or wget from another machine:
https://your-domain/cron.php?key=YOUR-CRON-KEY
The key is shown in the same Cron card and on the last step of the wizard. Without the right key the answer is Invalid cron key (403). The command line needs no key. You may add &job=queue to run one job, or &force=1 to run it even if it is not due. The jobs are heartbeat, queue, listing_expiry, search_alerts, pending_verifications, verify_recheck, registry_refresh, counters, currency_rates, sitemap, tickets, housekeeping, licence, update_check, plugins and plugins_daily.
After ten minutes open the admin Dashboard. The Automation (cron) widget should say Running. If it says Never ran or Late, see Troubleshooting.
5. Install in a sub-folder
You can install to https://example.com/market/. Upload and extract into the market folder and open https://example.com/market/. The script works out the folder by itself, so links, assets and the admin address (/market/admin) all follow. The shipped .htaccess says RewriteBase /; change it to RewriteBase /market/ for a sub-folder. The licence is bound to the host name (example.com), not to the folder. For the cron command use the full path of the cron/cron.php inside the sub-folder, and for the web cron use https://example.com/market/cron.php?key=....
6. After the install
- Sign in at
https://your-domain/adminwith the administrator you created. - Open Settings → System & Maintenance and check that the server card shows
dataanduploadsas writable and that no extension you need is red. - Open Settings → Licence and press Check now (see The licence key).
- Confirm the cron heartbeat on the Dashboard.
- Open Settings → General Settings → E-mail, fill in the sender and, if you use it, the SMTP server, save, then send a test e-mail to yourself.
- Continue with your first day.
7. Addresses worth knowing
| Address | What it is |
|---|---|
/ | The marketplace home page. |
/admin | The admin area. It sends you to /admin/login when you are not signed in. |
/login, /register, /password-reset | The member sign-in, sign-up and password reset pages. |
/health | A tiny JSON answer (ok, version, time). Handy for an uptime monitor. |
/sitemap.xml and /robots.txt | Made by the script. See Settings → General Settings → SEO. |
/api/v1 | The REST API index. See The REST API. |
/api-docs | The same API described for developers, on the site. |
/cron.php?key=... | The web cron address. |
8. Keep it safe
- Turn on two-factor sign-in for your own staff account right away: your name menu in the top bar → Two-Factor Authentication. See The admin tour.
- Use a long, unique password for the first administrator. The wizard accepts 8 characters; use more.
- Keep file permissions normal: folders 755, files 644.
config.phpmay be 600 or 640 if your host lets PHP still read it. - Switch on Force HTTPS (HSTS) once HTTPS works for the whole site.
- Never share the cron key. If it leaks, make a new one in the Cron card (Make a new key) and change the web cron address.
- Make a first SQL backup on Settings → System & Maintenance after the setup is done, and again before every update.
- Do not upload
config.phporinstalled.lockto anywhere public, and never put a copy of the database in the web folder.
9. If something fails
| You see | Do this |
|---|---|
| Step 1 stays red | Enable the extension or make the folder writable, then Check again. A red DNS lookups line means the host disabled dns_get_record; ask the host to enable it. |
Database: SQLSTATE... | Check host, name, user and password. On cPanel the user must be added to the database with all privileges. |
config.php could not be written. | Make the main folder writable for the wizard, or create config.php by hand from the lines in the wizard's error. |
Please give a valid e-mail address., The two passwords do not match. and similar | Step 3 shows the first problem it finds. Fix that field and press the button again. |
| Every page except the home page gives 404 | .htaccess is missing or mod_rewrite is off. |
| The wizard opens again after you finished | installed.lock was lost, for example by a restore that left out that file. Put it back (an empty file is enough) next to config.php. |
Invalid cron key | The address has the wrong key. Copy it again from the Cron card. |
To start over on a test installation, drop the tables from the database, delete config.php and installed.lock, and open the site again. Never do this on a marketplace with real members.
More in Troubleshooting.