Getting Started With Sympl
Sympl is designed to be easy to use and low maintenance, but there are a few things to be aware of.
Once Sympl is installed, your system with have a new user called
sympl, who should be used to manage the configuration of Sympl.
If you used the install script, the
sympl user will have a temporary password set which can be found by running
If you haven't done so already, you should change the password as soon as possible with the command
You may want to consider using SSH keys rather than logging in with a password, however you will still need a password for
Using the system
Where possible, Sympl discourages you from using the
root user when logging in and making any configuration changes.
This mainly applies to the
/srv/ directory and the firewall configuration in
If a directory in
/srv/ is owned by a system user (ie:
root, or a user with a UID lower than 1000), then it will typically be ignored.
If you do need elevated permissions for some action, then
sudo is available to the
Similarly, the MySQL root user should not be needed in 99.9% of cases. If you want to create a new database and user for a site, you can use the command
sympl create mysql databasename and Sympl will handle it for you and tell you the password.
A user named
sympl with effectively the same permissions was created when Sympl was installed, and you can access the MySQL command line directly with the
mysql command. However, if you need it the password for the
sympl user in MySQL, it can be found in
Manual Configuration Changes
If a configuration file has been generated by Sympl and is then edited by something else, it generally won't be modified by Sympl again. If this is the case, there will be a comment at the top of the file.
Using This Wiki
This wiki is designed as a one-stop location for all documentation for Sympl, and is aimed at a wide range of user skill levels.
When reading the guides here, and commands, files, directories and others are in
plain fixed-width text, with variables (elements you should change when typing something) are written in
bold italic fixed-width text,
If you can't find what you need here or something isn't clear, please post on the forum and let us know!