Quick deployment on Linux (up and running in 30 minutes)

Environment checks, installation, initialization and first sign-in on CentOS, Ubuntu, Kylin or openEuler.

1. Environment check

ItemRecommendation
CPU / memory4 cores and 8 GB minimum (8 cores and 16 GB for 200 users)
DiskSSD, with the data disk mounted separately
OSCentOS 7+ / Ubuntu 20.04+ / Kylin V10 / openEuler 20.03+
DependenciesNginx, PHP 8.1+, MySQL 5.7+/8.0 (or MariaDB 10.4+)

2. Upload and permissions

cd /www/wwwroot/your-domain
unzip selfhub-release.zip
chown -R www:www .
Please make sure the runtime/, uploads/ and config/ directories are writable by the account PHP runs as.

3. Initialize the database

  1. Create the database and the account in your database panel (charset utf8mb4).
  2. Write the initial token to runtime/.install_token.
  3. Open https://your-domain/install.php, fill in the database and administrator details and submit.
  4. Delete install.php immediately once installation finishes.

4. First sign-in

  • Public site: https://your-domain/
  • Admin: https://your-domain/admin, signing in with the administrator account you created
  • Open System tools and check that every data table and static entry reports Yes

5. Common problems

  • 404 on every page: make sure Nginx runs try_files $uri $uri/ /index.php?$query_string;. Without it the static entry files the system generates still keep the site reachable.
  • Styles look broken: check that assets/ was uploaded completely.
  • Cannot sign in to the admin area: check that the account role is super administrator or content editor.
Copy a link to this page